오류 및 제한

인증 및 검증 단계에서 실행 전에 요청이 거부될 수 있습니다. 오류 문서를 확인하고 지원 문의용 request_id를 보관하세요. 키나 비밀번호를 보내지 마세요.

응답 · HTTP

HTTP	설명
`400 / 422`	매개변수명, 유형, 범위 및 필수값을 확인하세요.
`401`	Authorization 헤더에 현재 유효한 키를 사용하세요.
`403`	계정 접근, 실제 권한, 인증 및 API 접속 IP 목록을 확인하세요.
`404`	본인 기록 ID를 확인하세요. 다른 계정 기록은 노출되지 않습니다.
`409`	재시도 전에 revision/견적을 다시 읽고 원래 작업 상태를 확인하세요.
`429`	Retry-After만큼 기다린 뒤 제한된 간격으로 조회하세요.
`5xx / timeout`	불확실한 쓰기는 실패와 다릅니다. 동일 작업을 조회하고 새 구매나 변경을 제출하지 마세요.

기본 한도는 달력 기준 분당 60회이며 관리자가 변경할 수 있습니다. capabilities.limits와 HTTP 429의 Retry-After를 따르세요. 키 갱신은 사용량을 초기화하지 않습니다.

HTTP 429

Retry-After: 15

{
  "ok": false,
  "error": { "code": "RATE_LIMITED" },
  "meta": { "request_id": "000000000000000000000429" }
}

각 쓰기 작업의 Idempotency-Key를 저장하세요. 시간 초과나 HTTP 5xx는 실패의 증거가 아닙니다. 같은 키로 상태를 조회하고 불확실성을 해결하려고 새 키로 다시 실행하지 마세요.