タイムアウトは失敗の確定ではない
注文要求を送った後で接続が切れると、クライアントには注文が保存されたか分かりません。サーバーで保存済みなのに、もう一度別の注文として受け付けると重複します。冪等性は同じ操作を繰り返したときの意図した効果が、一回の場合と変わらない性質です。応答内容が毎回同じであることとは区別し、何を一つの操作とみなすかを決めます。
キーを操作の識別子にする
クライアントは注文開始時に一意な操作キーを作り、再送でも同じキーを使います。サーバーは利用者と操作種類を含む範囲でキーを管理します。同じキーでも注文内容が異なる場合は、元の操作と衝突しているので拒否します。単に本文をハッシュ化すると、別の時刻に意図して同じ商品を買った注文まで同一視する可能性があります。
記録と効果を一緒に扱う
注文の作成とキーの記録の間に隙間があると、障害時に片方だけ残ります。可能なら同じDBトランザクションで記録し、キーに一意制約を設けます。二つの要求が同時に到着した場合も、一件だけが処理を確定できるようにします。外部決済まで含む場合は一つのDBトランザクションだけでは完結しないため、外部側の冪等性や状態機械との組み合わせが必要です。
期限と応答を設計する
完了済みなら保存した結果を返し、実行中なら待機や進行中の応答を返すなど、各状態の扱いを決めます。キーを24時間後に消す設計なら、その後の再送まで重複を防ぐ保証はありません。処理の最大再試行期間に合わせて保持期間を設計します。認可は再送でも必要で、キーを知っていること自体を他人の結果を読む権限にしません。
HTTPメソッド名だけに頼らない
HTTPではPUTやDELETEなどの意図した意味が冪等と定義されていますが、実装がその意味を守っている必要があります。POSTでも操作キーで重複を制御するAPIは作れます。逆にPUTという名前だけで、内部の請求や通知まで重複しないとはいえません。再送の可否は、メソッド、アプリケーションの効果、保存された操作記録を合わせて判断します。