瀏覽全部文件

Webhook API 參考

附簽章、至少一次的事件交付,支援歷史紀錄與重播

目的地

十個需要身分驗證的路由可用於建立、列出、檢視、更新、輪替、測試和刪除目的地,還可讀取設定與交付歷史,並重播單次交付。目的地的篩選條件始終限於帳戶目前有效的國家與資料類別授權。 Webhook 目的地上限:Free 為 1,Basic 為 3,Pro 為 10。

預測事件

包含predictions類別的目的地會在事件交易停止時收到prediction.event.closed,並在事件結算或作廢時收到prediction.event.settled。每個事件的每種通知最多傳送一次。本文包含事件狀態,絕不包含機率或獲勝結果。

簽章與重試

將 x-narwhal-signature 視為以 timestamp + "." + raw_body 計算的 HMAC-SHA256 進行驗證。交付保證至少一次。僅在持久化處理完成後回傳 2xx 回應,並依交付 ID 去除重複。

歷史與重播

交付歷史會記錄每次嘗試的狀態與回應狀態。重播會為同一個不可變事件建立新的交付。密鑰輪替設有重疊期,接收端可驗證所公布的任一簽章。