/v1 のすべてのエラーレスポンスは application/problem+json（RFC 9457）形式であり、固定のフィールドセットで構成されます。
code を使用し、detail は使用しないでください。code は安定したマシンコントラクトであり、detail は人が読むためのものであり、変更される場合があります。param は、エラーが特定のリクエストパラメーターに起因する場合に含まれます。サポートに問い合わせる際は、request_id を含めてください。
エラーコード
コードセットは固定されています。新しいコードの追加はパブリックコントラクトの変更にあたり、API の変更履歴を通じて告知されます。
retryable: true レスポンスは、状況が解消される可能性があることを意味しますが、書き込みが何の影響も及ぼさなかったことを保証するものではありません。読み取りリクエストは、試行回数と所要時間に上限を設け、指数バックオフとジッターを用いて再試行してください。再試行可能な 409 や 429 の場合を含め、Retry-After が存在するときはそれに従ってください。
変更操作については、その操作に関して文書化されている冪等性およびリカバリーのコントラクトに従ってください。サポートされている場合は、元のキーとリクエストを保持してください。タイムアウトや 5xx の後に新しいキーを作成しないでください。成功済みの書き込みが重複して実行される可能性があります。Idempotency-Key ヘッダーは、それをサポートしていない操作では何の保護も提供しません。