後端、資料與安全 深入了解 C · 業界慣例

Webhook

Webhook 回呼

Webhook 是事件發生時向外送出的 HTTP 回呼,用來通知另一個系統採取動作。

看看怎麼運作
也有人這樣說 Webhook事件回呼通知端點

看看怎麼運作

原創情境範例Webhook 回呼

另一個例子

付款服務會把經過簽章的 payment.succeeded 事件送到訂單服務。

主要部分

  1. 01來源請求
  2. 02解析或處理節點
  3. 03回應、時間與失敗狀態

什麼時候用

每份內容都要簽章,處理方式要具備冪等性,傳送失敗要重試,也要保留可長期查核的事件紀錄。

什麼時候不要用

不要假設事件會依序抵達或只送一次,也不要信任尚未驗證的傳送端。

程式裡的名稱

POST callback + signature

上線前要檢查

檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。

可以直接複製的需求

預期成果:為這套系統設計或檢查 Webhook 回呼 (Webhook),並讓資料保持正確、安全且容易維護。 使用者情境:付款服務會把經過簽章的 payment.succeeded 事件送到訂單服務。 技術概念或控制措施:Webhook 回呼 (Webhook)。 適用理由:每份內容都要簽章,處理方式要具備冪等性,傳送失敗要重試,也要保留可長期查核的事件紀錄。 不應使用的情況:不要假設事件會依序抵達或只送一次,也不要信任尚未驗證的傳送端。 工程要求:定義輸入、輸出、介面約定,以及任何情況都不能破壞的規則。說明授權與輸入檢查範圍。定義失敗、逾時、重試和重複執行只生效一次的規則。也要定義資料搬移與相容限制。 營運要求:加入監控訊號與隱藏敏感資料的記錄。設定容量上限並寫好操作手冊。測試復原與回復上一版的流程。 驗收條件:介面約定與失敗路徑測試通過。重試或部分失敗時,資料與授權規則仍正確。效能上限、監控、復原與回復上一版的方法都已驗證。 證據與限制(證據邊界):沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。 待確認:程式執行環境、資料位置、流量形態、資料一致需求和安全邊界。也要確認相容期間、服務目標(SLO)與回復上一版的限制。

檢查這份需求

請 AI 程式助手檢查目前如何使用 Webhook 回呼 (Webhook)。 定義:Webhook 是事件發生時向外送出的 HTTP 回呼,用來通知另一個系統採取動作。 正式環境檢查:檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

C
這個術語有多正式?

業界慣例

工作上常會用到這個術語。列出的來源可能說明用法或限制,但不會定義全部內容。

沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。

適用範圍
只包含來源有說明的內容:正式名稱、定義、使用指南、避免事項
文件狀態
穩定
查證日期
2026-07-30

證據來源與適用範圍

正式來源 · GitHub · 穩定 About webhooks 適用範圍: 正式名稱、定義、使用指南、避免事項 本頁用途: 提供背景,不是正式定義 來源涵蓋內容: 正式名稱, 定義, 使用指南, 避免事項

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。