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