API 平台

回调安全规则

异步任务通过 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"
}
字段类型说明
TaskIDstring任务 ID,用它调用任务查询接口获取完整结果
TenantIDstring租户 ID
Statusstring任务终态,可能值:SUCCESSFAILED
CallbackURLstring本次回调命中的 webhook_url