에러

포샌디 API는 모든 에러를 같은 모양으로 보내요. 코드는 무엇이 잘못됐는지 구체적으로 알려 주고, 문장에 들어간 숫자 값은 따로 필드로도 보내요.

모양

실패하면 error 객체가 와요. 그 안에 code와 영어 문장 message가 있어요. message에 들어간 값(채널, 한도, 실제 값 등)은 별도 필드로도 와요. 이 값으로 한국어 안내 문장을 직접 만들 수 있어요.

{
  "error": {
    "code": "content_too_long",
    "message": "Threads allows 500 characters. This is 620.",
    "platform": "threads",
    "limit": 500,
    "actual": 620
  }
}

위 예시는 422 응답이에요.

같은 요청이 두 번 가지 않게 막는 방법

중복 발행은 두 단계로 막아요.

1. Idempotency-Key 헤더: 이 헤더를 넣으면 같은 요청을 다시 실행하지 않고 저장해 둔 응답을 그대로 돌려줘요. 성공한 결과는 24시간 보관해요. 같은 키로 다른 본문을 보내면 idempotency_key_reused로 거절해요.
2. 내용 비교: 같은 글과 같은 파일이 같은 계정으로 10분 안에 다시 오면 duplicate_post로 거절해요. 실패한 글을 재시도할 때도 같은 비교를 해요. 10분이 지났더라도 같은 계정에 같은 내용의 다른 글이 있으면 duplicate_post로 거절해요.

일부러 같은 글을 다시 올리는 거라면 force: true를 넣어요.

위반이 여러 개면 한 번에 와요

규칙을 두 개 이상 어기면 error.errors에 전부 담겨 와요. 첫 번째 항목은 error 자리에도 그대로 들어 있어요. 그래서 한 번에 다 고칠 수 있어요. 재시도할 때마다 다음 위반을 하나씩 확인하지 않아도 돼요.

예외는 두 개예요. no_accounts와 empty_content는 다른 검사를 하기 위한 전제 조건이라 혼자 와요.

메시지는 항상 영어예요

화면은 한국어와 영어를 지원하지만, API 메시지는 영어로만 와요. 응답이 언어마다 달라지면, 같은 요청에 묻는 사람마다 다른 답이 오게 되기 때문이에요. 화면에 보여 줄 문장은 message가 아니라 code를 기준으로 만들어요.

코드

코드별로 더 자세한 해결 방법은 안 될 때에 있어요.