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管理，上传编码见小文件上传。