Idempotency - 同じ要求を何度受け取っても結果を 1 回分に保つ

決済 API に課金の POST を送り、504 Gateway Timeout が返ってきたとします。課金が成立したのか、要求が届かないまま終わったのかは、この応答からは分かりません。 冪等(べきとう、idempotent)は、同じ操作を 1 回実行した時と、繰り返し実行した時とで、要求した側が意図した結果が同じになる性質です。上の POST が冪等なら、もう一度送っても課金は 1 回分に留まります。本ノートでは、要求の再送で生じる重複を扱い、誤った値を返す故障(ビザンチン障害)と、複数の要求を跨いだ順序の保証は対象外とします。 ...

2026年8月18日 · 更新: 2026年8月19日 · 10 分 · nchika