开发者平台管理员
Webhook 验签、重试与去重
通过 HMAC 验签与至少一次投递处理接收客服事件。
- 适用对象
- 管理员
- 指南深度
- 2 个步骤
- 内容审核
- 2026-07-22
完成后能获得什么
这里说明按指南操作后的实际结果，同时保留当前产品边界。
登记并验签
只有真实请求进入处理。
确认、去重并轮换
重试与轮换不会产生重复工作。
开始前
- Max 或 Enterprise 套餐，以及公网 HTTPS 接收端
- 接收端能够保存已处理的 event ID
操作步骤
登记并验签
只选择所需事件。对 timestamp + "." + 完整原始 body 计算 HMAC-SHA256，恒定时间比较 X-AOS-Signature，并拒绝过旧时间戳。系统拒绝内网、回环、链路本地、含凭据与跳转目标。
预期结果: 只有真实请求进入处理。
确认、去重并轮换
保存 X-AOS-Event-Id 并尽快返回 2xx。网络错误、408、425、429 与 5xx 会重试，其他 4xx 终止。投递为至少一次。密钥轮换有 24 小时双签名重叠期。
预期结果: 重试与轮换不会产生重复工作。