오류 처리

HTTP 상태와 응답 본문을 함께 확인합니다. 오류 필드는 엔드포인트마다 다르므로 정확한 계약은 API 상세 명세를 확인하세요.

• 타임아웃이나 일시적인 5xx 오류가 발생하면 반환받은 콘텐츠·작업 ID로 상태를 먼저 조회합니다. 같은 작업을 재시도할 때는 동일한 요청 내용과 idempotency_key를 유지하고 횟수를 제한해 대기 시간을 늘립니다. HTTP 202는 접수이며 발행 성공이 아닙니다.
• 409 idempotency_conflict는 기존 요청과 결과를 비교해야 합니다. 새 키를 자동 생성하지 마세요. 이전 작업의 결과를 확인한 뒤 의도적으로 새 작업을 시작할 때만 새 키를 사용합니다.
• 잘못된 입력이나 인증·권한 문제를 해결한 뒤 재시도합니다. 429는 오류와 제공된 Retry-After를 확인하세요. 요금제 한도 소진은 잠깐 기다리는 대신 한도 초기화나 요금제 변경이 필요할 수 있습니다.

{
  "error": "insufficient_scope",
  "message": "publishing:write scope is required for this API request."
}

• API
• HTTP 202