webhook / retry / idempotency / local-only
再送・重複・冪等キーを確認
合成deliveryで、event id・retry・idempotency keyの関係を比較します。受信先への送信や実データの保存はありません。
固定delivery例
| case | event id | retry | idempotency key | 判断 |
|---|---|---|---|---|
| 初回 | evt_100 | 0 | pay_100 | 処理 |
| 再送 | evt_100 | 1 | pay_100 | 重複を無視 |
| 別delivery | evt_101 | 0 | pay_101 | 別処理 |
| 順序逆転 | evt_099 | 1 | pay_099 | 状態を再確認 |
| 期限切れ | evt_098 | 2 | pay_098 | 再処理せず確認 |
合成例を端末内で確認できます。
分けて持つ値
- event idはdeliveryの識別に使う。
- retryは再送回数であり、成功を意味しない。
- idempotency keyは同じ処理を一度だけにする境界を決める。
- 順序逆転と期限切れは、重複判定だけで成功扱いにしない。