Webhook 的核心概念是「外部系統主動把事件推送到你的 endpoint」。它常用於支付、物流、第三方整合通知。 可先對照 Website Certificate Lifecycle。

概念位置

Webhook 通常需要來源驗證、重放防護、重試處理與可追蹤事件 ID。 可先對照 Website Certificate Lifecycle。

設計責任

設計時要定義簽章驗證、時窗限制、冪等處理與錯誤回應策略，避免假請求或重放造成狀態錯誤。

冪等處理這一項在對外整合時要逐家讀條款：各 vendor 用來去重的 header 名稱不同是命名之爭，而重送回什麼、事件保留多久才是語意之爭，後者跟業務形態綁在一起、沒有標準可依（見 Idempotency key 標準化之爭）。各家的投遞承諾差異見 webhook 對外承諾。