01 / 重複を区別
同じイベントを2回送る。内容が同じなら重複扱い、同じIDで内容が変われば競合として止める。
受信202 → 重複200/競合409
NK-RELAY LAB / Python
署名検証から重複・再試行・失敗キューまで。合成データを使って、連携障害を手元で再現するPython教材です。
本番用コネクタではありません。すべての通信はローカルの127.0.0.1内で行います。
同じイベントを2回送る。内容が同じなら重複扱い、同じIDで内容が変われば競合として止める。
受信202 → 重複200/競合409
模擬送信先には保存済みでも、応答が途切れる状況を再現。同じ冪等キーで再送した結果を確認する。
模擬送信先:送信2回・保存1件
一時的な503と恒久的な422を比べ、再試行上限・DLQ・監査付き再実行の違いを読む。
成功3件・DLQ1件のデモ
「送信2回・保存1件」は同梱の模擬送信先が冪等性を実装した結果です。任意の外部APIに対するexactly-once保証ではありません。Stripe・GitHub等の公式Webhook仕様との互換性も提供しません。
送信側が応答を受け取れなくても、受信側の処理は完了していることがあります。安全な再送には、再試行だけでなく「同じ仕事を識別するキー」と「処理結果を一度だけ保存する送信先」の組合せが必要です。この教材では両側を観察します。
AIを用いて制作した教材を実行検証しています。公開中の試作品を学習用に整理したもので、本番導入実績や顧客の成果を示すものではありません。
このページの条件が本教材に適用されます。別商品の中国語制作・55,000円の個別技術検証とは範囲も納期も異なります。
購入後1営業日以内にZIPをメール納品します。納品後のお客様都合の返品は不可。同梱不備には上記条件で修正・返金対応します。事業用の学習教材であり、本番運用システムや個別開発ではないことをご確認ください。
条件を確認して3,300円の購入手続きへStripeの最終画面で商品・金額・納品条件への同意を入力し、支払操作を行うと申込みになります。購入済みの方は重ねて支払わないでください。個人情報保護方針
自社の実際の連携1経路を検証したい場合は、別商品の個別技術検証をご確認ください。本教材の購入は必須ではありません。