搜尋與 AI
冪等性是什麼？
Idempotency
發布於
冪等性（Idempotency）是相同請求重複執行時，對伺服器產生的預期效果與執行一次相同的性質。它不要求每次回應文字或狀態碼完全一致，也不代表請求一定成功。
Idempotency key冪等鍵
冪等鍵用來識別同一項操作的重試。只有服務端支援並依契約處理相同鍵值、參數與保存期限時，客戶端重送才有對應的去重保障；隨意加一個欄位不會自動生效。
為什麼代理人需要安全的重試方式
訂位請求送出後逾時，可能是後端尚未處理，也可能是訂單已成立、只有回應遺失。立即再送一次建立請求，可能造成兩筆訂位。
產品可提供查詢既有狀態的方式，並在支援的操作中使用冪等鍵。代理人應依服務契約查詢或重試，不能把「沒有收到回應」直接當成「沒有執行」。
HTTP 方法與業務操作要一起看
RFC 9110 將 PUT、DELETE 與安全方法定義為冪等方法；使用 POST 建立訂單，並不因為採用 HTTP 就自動具備相同保障。像 Stripe 的 POST API，則另外提供冪等鍵機制。
冪等性處理的是重複操作的效果；授權、參數是否符合使用者要求，以及結果能否被確認，仍需另外驗證。
參考資料
最近查核：