跳至主要內容

INSIGHTS

文章分享

技術筆記

系統串接要測試哪些項目?從資料同步到異常處理

除了 API 成功回應,還要確認資料正確、重複事件不重做,以及失敗後能追查與補救

系統串接驗收要包含什麼?

至少要涵蓋資料對應、正常流程、重複與延遲事件、失敗復原、權限及交接。API 回傳成功可能只代表請求已被接收,不代表訂單、庫存與通知都完成了;驗收應追到目標系統中的實際結果。

先確認一筆資料從哪裡來

整合測試的起點不是列出 API 數量,而是選一個完整情境。例如會員建立訂單後,哪些系統需要知道、誰保有主資料,以及更新應在什麼時候發生。這裡是規劃範例,不是特定專案的交付紀錄。

  • 明確定義來源系統與目標系統
  • 核對訂單編號、金額單位、日期與時區,確認空值及缺少必填欄位的處理
  • 列出存取權限與不能傳送的資料
筆電上的整合後台畫面:CRM、檔案與 ERP 三個來源連到同一份整合紀錄,下方列出各筆資料的同步狀態
整合後台示意:多個來源系統的資料匯入同一份紀錄,並逐筆顯示同步狀態

同一筆訂單送兩次會發生什麼?

網路中斷後重送,可能讓同一操作執行兩次。測試時應用同一筆訂單重送,確認不會建立第二張訂單或重複扣庫存,而不只是檢查回應成功。

以 Stripe 為例,官方文件提供冪等請求機制,讓符合條件的重試沿用同一操作結果;Webhook 文件也提醒要處理重複與順序不同的事件。其他服務的規則可能不同,應逐一確認。

逾時或只完成一半,要怎麼補救?

成功回應只涵蓋一種情況。逾時、重複請求、權限不足與部分完成,都需要約定可以觀察到的結果。重試並非永遠安全,涉及付款或庫存時尤其要先確認重複操作的風險。

  • 逾時後是否能查到原本的執行狀態
  • 重複事件如何辨識與處理
  • 失敗紀錄如何追蹤而不洩露敏感資料
  • 哪些情境交由人工確認而不是自動重試
  • 訂單已建立但通知失敗時,只補送通知,不重新建立訂單

留下接手的人需要的資訊

交接應包含測試環境、介面說明、錯誤情境與負責窗口。實際驗收項目仍要依第三方限制與專案風險調整,這份清單不能取代完整的安全或法遵評估。

常見問題

讀完這篇,可能還想問的

API 回傳成功,是否就代表串接完成?

不一定。成功回應可能只代表請求已被接收,驗收時要到目標系統確認實際結果,例如訂單是否建立、庫存與通知是否正確更新。

串接失敗時,可以直接設定自動重試嗎?

要先確認重複執行的影響。涉及付款或庫存時,重複操作可能造成重複扣款或扣庫存;可以搭配服務提供的冪等機制,或把這類情境交由人工確認。

這份驗收清單可以直接套用到每個專案嗎?

不能直接套用。實際項目要依第三方服務的限制與專案風險調整,這份清單也不能取代完整的安全或法遵評估。