Webhook：業務処理を重複させずイベントを受け取る

公開 09/05/2026 · 更新 18/10/2026 · APIと連携サービス · 2 分で読めます · 執筆 Cyber Intelligence Embassy

要点

WebhookはHTTPでイベントを通知します。即時配信、順序、業務上の効果が厳密に1回だけであることを一律には保証しません。

この記事の内容

保証は提供元によって異なります。Stripeは重複の可能性と順序を保証しないことを明記しています。HTTP成功応答は、単にメモリーへ届いたことではなく、永続的な受信または予定した処理に対応させます。

提供元のプロトコルに従ってHTTPS、署名、リプレイ対策を確認します。Stripeは生の本文で署名を検証し、先にJSONを変換すると検証できなくなる場合があります。
適切な受領応答の前にイベントまたは処理を永続化します。配信ID、イベントID、業務処理の冪等キーを区別します。
重複、順序違い、ワーカー中断、再起動を試験します。古いイベントだけで安全に判断できなければ、正本のオブジェクト状態を取得します。

試行、期限、未処理イベント、提供元との照合手順を文書化します。速い受領応答が後続の失敗を隠す場合があります。最終的な業務処理も監視し、秘密や個人情報のログを制限します。

タイムアウトまたは応答の消失後、通知が繰り返される場合があります。信頼性は、オリジン検証、イベント識別子、および新規メッセージと重複メッセージを区別する処理に依存します。