REST API

에러 코드

무엇이 잘못됐고 어떻게 고치는지.

모든 오류 응답에는 error 코드와 사람이 읽을 수 있는 message 가 들어 있습니다. 응답 헤더의 x-request-id 를 남겨두면 문의가 훨씬 빨라집니다.

코드

이름	타입	설명
`invalid_api_key`	401	키가 없거나 폐기됐습니다. 대시보드에서 새로 발급하세요.
`account_expired`	401	소셜 계정 토큰이 만료됐습니다. Connections 에서 다시 연결하세요.
`forbidden_scope`	403	읽기 전용 키로 발행을 시도했습니다. read_write 키를 쓰세요.
`content_too_long`	422	플랫폼 글자수 제한을 넘겼습니다. message 에 몇 자 초과인지 나옵니다.
`media_required`	422	Instagram·YouTube 는 미디어 없이 발행할 수 없습니다.
`media_mixed`	422	이미지와 영상을 한 게시물에 섞었습니다.
`quota_exceeded`	429	무료 플랜 월 발행 한도를 넘겼습니다. Pro 로 올리면 무제한입니다.
`rate_limited`	429	요청이 너무 잦습니다. retryAfter 초 뒤 재시도하세요.
`internal_error`	500	일시적인 오류입니다. x-request-id 를 포함해 문의해 주세요.

오류 응답 형태

HTTP/1.1 422 Unprocessable Entity
x-request-id: req_7c2ef03a88

{
  "error": "content_too_long",
  "message": "Threads 는 500자까지 허용합니다. 현재 572자입니다.",
  "platform": "threads"
}