開發指南

系統接駁偶爾漏單:Webhook 與 API 失敗怎樣復原?

同一通知可能來幾次,也可能遲到。記下每個事件收到後做了甚麼,出錯時才查得到是否要重試、補單或交人跟進。

ProApp 編輯發布及核對日期
網絡交換器與藍黃網絡線
AI 生成情境圖,用作說明文章主題。

本文以假設流程說明設計方法,並非客戶案例。

流程設計示意
  1. 保存事件
  2. 安全處理與重試
  3. 定期核對

請求逾時後,先查對方有沒有開單

兩個系統都正常運作,交接資料時仍可能漏了一次。請求逾時尤其難判斷:對方可能已寫入資料,只是未回覆;這時重送,就可能開出兩張單。接駁記錄要分清收到通知、開始處理和確認結果,才有依據決定下一步,也避免因不敢重試而漏單。

連接工具有沒有重試和補跑?

檢查現有連接工具有沒有錯誤記錄、重試和補跑功能。Stripe 的 Webhook 文件也列出重複及次序問題;自行接駁時,要按各平台規則處理,不能假設每個通知只來一次,或一定依序送達。

記住每個事件處理到哪一步

先處理一條重要流程,驗證通知來源並保存事件編號,再排隊執行。失敗的項目要顯示原因,重試前先查動作是否已完成。未能自動復原的記錄,讓同事按既定程序跟進,並定期與來源系統對數,找出漏掉的部分。

重播一次,會不會再扣款?

把同一事件重播一次,確認不會再次扣款或發貨,再試通知次序顛倒、接口限流、對方停機和逾時。工作只完成一部分時,也要知道如何接着處理。驗收時要找得到真正漏掉的記錄、能補回,通知亦能讓同事判斷哪些失敗需要跟進。

整理一次失敗的處理記錄

準備已刪去個人資料的事件時間及處理記錄、接口文件、錯誤訊息,以及正常結果的例子。

想處理類似問題?

告訴我們目前怎樣做、用了哪些工具,以及想改善甚麼。我們可一起看看是調整現有系統、加入連接,還是需要新開發。