Webhook 可靠性

Webhook 接口的目标是可靠接收事件，不是在 HTTP 请求里完成全部业务。正式环境应先校验基本请求、记录事件并入队，然后快速返回成功。

接收链路

公网 HTTP/HTTPS → 基础校验 → 幂等检查 → 事件入队 → 快速响应
                                      ↓
                              异步业务处理与重试

必做项

项目	要求
可访问性	使用公网可访问的 HTTP 或 HTTPS 完整地址；生产环境建议使用 HTTPS
响应时间	6 秒内返回，数据库慢操作和第三方调用放入队列
幂等	使用 newMsgId 或业务唯一键避免重复处理
可观测性	记录事件类型、消息 ID、耗时、处理结果和重试次数
数据最小化	日志只保留排查必需字段，敏感内容脱敏或不记录

不要猜测签名字段

只使用当前接口文档明确给出的字段。不要自行添加或推导文档未定义的签名参数；如生产环境需要额外来源校验，请联系技术支持确认当前租户能力。

开发阶段先按 Webhook 本地联调 验证事件，再按 回调事件索引 建立分发规则。