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 去重。
历史与重放
交付历史记录每次尝试的状态和响应状态。重放会为同一个不可变事件创建新的交付。密钥轮换设有重叠期,接收方可以验证所公布的任一签名。
文档