回调安全规则
异步任务通过 webhook_url 回调终态结果。URL 必须是公网可访问的 HTTPS 地址。
URL 校验
| 规则 | 说明 |
|---|---|
| 协议 | 必须使用 HTTPS |
| 禁止地址 | localhost、127.0.0.1、私网地址、回环地址、内部域名 |
| 数据格式 | 服务端以 POST JSON 方式发送精简的任务终态通知对象,不包含完整任务结果 |
| 失败处理 | 回调失败重试策略以研发最终实现为准 |
回调请求体
任务到达终态后,服务端向 webhook_url 发起一次 POST JSON 回调。请求体是精简的终态通知对象,仅用于告知任务已完成,不包含结果 URL 等完整字段。
{
"TaskID": "<task_id>",
"TenantID": "<tenant_id>",
"Status": "SUCCESS",
"CallbackURL": "https://example.com/webhook"
}
| 字段 | 类型 | 说明 |
|---|---|---|
TaskID | string | 任务 ID,用它调用任务查询接口获取完整结果 |
TenantID | string | 租户 ID |
Status | string | 任务终态,可能值:SUCCESS、FAILED |
CallbackURL | string | 本次回调命中的 webhook_url |