APIエラー、リトライ、冪等性の扱い方

うまくいく道筋だけでなく、失敗を前提に設計しましょう。最も危険なのは曖昧なケースです。接続が切れる前に、成功したかもしれないし、しなかったかもしれないリクエストです。

注文リクエストに冪等性キー（idempotency key）を使えば、タイムアウト後の安全なリトライで、重複した請求を作る代わりに既存の注文が返されます。一時的なエラー（レート制限、一時的な5xx）は、増加するバックオフと上限を設けてリトライしてください。

不正なリクエストや残高不足のような恒久的なエラーは早めに失敗させ、人に見えるようにしましょう。それらをリトライしても時間の無駄です。後で照合できるよう、すべてのリクエストとレスポンスを注文IDとともに記録してください。