開発ガイド

システム間で記録が抜ける:Webhook・API連携を復旧するには

同じ通知が何度も届いたり、遅れて届いたりすることがあります。受信後の処理を記録しておけば、再試行するのか、欠けた記録を復旧するのか、調査が必要なのかを判断できます。

ProApp 編集公開・確認日
ネットワークスイッチと青・黄のLANケーブル
記事の場面を表すAI生成イメージです。

フローは設計を説明するための例であり、顧客事例ではありません。

業務フローの設計例
  1. イベントを保存
  2. 処理・安全に再試行
  3. 定期照合

タイムアウト後に登録済みか確認する

両方のシステムが動いていても、受け渡しが失敗することはあります。タイムアウトしたときは、相手が登録を終え、返信だけが届かなかった可能性があります。そのまま再送すると重複するかもしれません。受信、処理、反映の確認を分けて記録すれば、次の対応を判断でき、再送を避けたために欠落を残すことも防げます。

再試行と復旧機能を確認する

まず連携サービスのログ、再試行、再実行の機能を確認します。StripeのWebhook資料では、通知の重複や順序の入れ替わりが説明されています。各サービスの仕様に合わせ、一度だけ順番どおりに届くことを前提にしない設計が必要です。

各イベントの処理状況を記録する

重要な一つの業務を選び、届いた通知を検証して番号を保存し、処理を順番待ちにします。失敗した項目には理由を表示し、再試行の前にすでに反映されていないか確認します。人の対応が必要な案件には復旧手順を用意します。元システムとも定期的に照合して欠落を探します。

再実行で二重請求にならないか

同じイベントを再実行し、二重決済や二重出荷にならないか確認します。そのうえで、通知の順序の入れ替わり、API制限、停止、タイムアウト、一部だけ完了した処理を試します。抜けた記録を見つけて復旧でき、対応が必要な失敗を通知から判断できることを確かめます。

失敗した処理の履歴を用意する

個人情報を除いた通知の時系列と失敗ログ、API資料、各ケースで期待する結果を用意してください。

同じような課題でお困りですか?

現在の進め方、使っているツール、改善したい点をお聞かせください。既存システムの変更、ツールの連携、新規開発のどれが合うか一緒に考えます。