Webhooks

接收流程

在應用的Webhooks頁登記HTTPS接收地址與訂閱事件，安全保存一次展示的原始signing_secret。註冊事件名只是訂閱配置；可投遞的事件取決於對應業務服務實際生產者，不把示例事件列表當成已上線事件目錄。

發送端POST原始JSON body，X-Webhook-Signature是64位小寫hex，X-Webhook-Event是未簽名的事件header。接收方依次執行：獲取raw body → 官方SDK驗籤 → JSON解析與業務校驗 → 返回成功響應。

當前簽名不包含時間戳或投遞ID。驗籤不能防重放，也不認證event header。重複處理保護使用你自己業務合同中的可信標識，不依賴虛構的投遞header。

生命週期

控制檯當前提供註冊、密鑰輪換與刪除。它沒有投遞歷史、手動重投、發送測試事件或暫停隊列操作。不要依賴自動重投次數/時間表；按業務服務實際投遞合同評估失敗處理，並讓接收邏輯可重複處理。

輪換立即替換髮送端secret；消費者可短期配置多個本地secret接收在途請求，無服務端雙籤窗口承諾。刪除端點與輪換均會影響接收服務，操作前安排好配置更新。

完整代碼見簽名驗證，詳細操作見Webhook管理，上傳編碼見小文件上傳。