/v1 오류 응답은 고정된 필드 집합을 가진 application/problem+json(RFC 9457)입니다.
code를 기준으로 하고 detail는 기준으로 삼지 마십시오. code는 안정적인 머신 계약이며, detail는 사람이 읽을 수 있는 설명으로 변경될 수 있습니다. param는 오류가 특정 요청 매개변수에서 비롯된 경우에 포함됩니다. 지원팀에 문의할 때는 request_id를 함께 전달하십시오.
오류 코드
코드 집합은 고정되어 있으며, 새로운 코드 추가는 공개 계약의 변경에 해당하므로 API 변경 로그를 통해 공지됩니다.
retryable: true 응답은 해당 상태가 해소될 수 있음을 의미할 뿐, 쓰기 작업이 아무런 영향을 주지 않았음을 보장하지는 않습니다. 읽기 요청은 시도 횟수와 시간 예산을 한정하고 지수 백오프와 지터를 적용하여 재시도하십시오. 재시도 가능한 409 또는 429 응답을 포함하여 Retry-After가 있는 경우에는 이를 준수하십시오.
변경 작업(mutation)의 경우 해당 작업에 문서화된 멱등성 및 복구 계약을 따르십시오. 지원되는 경우 원래의 키와 요청을 그대로 유지하십시오. 타임아웃이나 5xx 이후에 새 키를 임의로 생성하지 마십시오. 그렇게 하면 이미 성공한 쓰기가 반복될 수 있습니다. Idempotency-Key 헤더는 이를 지원하지 않는 작업에서는 어떠한 보호도 제공하지 않습니다.