POST 请求。
消息投递支持自动重试和指数退避。
需要设置 Webhook 目标地址?请按照入门指南中的步骤操作。
要求
您的 Webhook 端点必须满足以下要求:| 要求 | 详情 |
|---|---|
| HTTPS | 目标 URL 必须使用 HTTPS |
| 200 响应 | 在 30 秒内返回 200 状态码以确认收到 |
| 幂等性 | 处理重复投递 — 参阅 Webhook 处理指南 了解每种事件类型的去重策略 |
事件类型
所有目标地址自动接收全部事件类型,不支持按事件过滤。通用 Payload 字段
每个 Webhook 事件都包含以下基础字段:| 字段 | 类型 | 说明 |
|---|---|---|
event_type | string | 事件标识符(state_change、media_rejected、invalidate_sr) |
sr_uuid | string | 服务请求 UUID |
reference_id | string | null | 您的内部商品 ID(创建服务请求时设置的 external_id) |
timestamp | string | 事件发生时的 ISO 8601 时间戳 |
重试机制
投递失败(非 2xx 响应或超时)将通过指数退避策略自动重试:| 尝试次数 | 延迟 |
|---|---|
| 1 | 立即 |
| 2 | 约 5 秒 |
| 3 | 约 5 分钟 |
| 4 | 约 30 分钟 |
| 5 | 约 2 小时 |