系統串接要測試哪些項目?從資料同步到異常處理
除了 API 成功回應,還要確認資料正確、重複事件不重做,以及失敗後能追查與補救

INSIGHTS
文章分享除了 API 成功回應,還要確認資料正確、重複事件不重做,以及失敗後能追查與補救
至少要涵蓋資料對應、正常流程、重複與延遲事件、失敗復原、權限及交接。API 回傳成功可能只代表請求已被接收,不代表訂單、庫存與通知都完成了;驗收應追到目標系統中的實際結果。
整合測試的起點不是列出 API 數量,而是選一個完整情境。例如會員建立訂單後,哪些系統需要知道、誰保有主資料,以及更新應在什麼時候發生。這裡是規劃範例,不是特定專案的交付紀錄。

網路中斷後重送,可能讓同一操作執行兩次。測試時應用同一筆訂單重送,確認不會建立第二張訂單或重複扣庫存,而不只是檢查回應成功。
以 Stripe 為例,官方文件提供冪等請求機制,讓符合條件的重試沿用同一操作結果;Webhook 文件也提醒要處理重複與順序不同的事件。其他服務的規則可能不同,應逐一確認。
成功回應只涵蓋一種情況。逾時、重複請求、權限不足與部分完成,都需要約定可以觀察到的結果。重試並非永遠安全,涉及付款或庫存時尤其要先確認重複操作的風險。
交接應包含測試環境、介面說明、錯誤情境與負責窗口。實際驗收項目仍要依第三方限制與專案風險調整,這份清單不能取代完整的安全或法遵評估。
讀完這篇,可能還想問的
不一定。成功回應可能只代表請求已被接收,驗收時要到目標系統確認實際結果,例如訂單是否建立、庫存與通知是否正確更新。
要先確認重複執行的影響。涉及付款或庫存時,重複操作可能造成重複扣款或扣庫存;可以搭配服務提供的冪等機制,或把這類情境交由人工確認。
不能直接套用。實際項目要依第三方服務的限制與專案風險調整,這份清單也不能取代完整的安全或法遵評估。