跳转到内容

接入指南

完成通知

接收单个任务的完成通知并验证签名。

使用 PUT /v1/webhook 设置账户默认通知地址,也可以在每个任务中传入 webhookUrl。通知地址必须使用 HTTPS。通过 GET /v1/webhook 获取当前账户的 signingSecret。

每个任务结束后单独发送一次逻辑通知:

{
"event": "task.finished",
"deliveryRevision": 1,
"task": {
"taskId": "00000000-0000-4000-8000-000000000001",
"state": "completed",
"content": "回答内容",
"revision": 1
}
}

请求头:

  • X-Douzhi-Signature: sha256=<hex digest>
  • X-Douzhi-Delivery: <delivery id>

使用通知验签密钥,对原始请求字节计算 HMAC-SHA256。验签成功后尽快返回 HTTP 2xx。网络重试可能重复发送,请按 X-Douzhi-Delivery 去重。

需要更换密钥时调用 POST /v1/webhook/signing-secret/rotation。轮换成功后,后续通知立即使用新密钥。

通知内容超过大小限制时,task.resultOmitted 为 true,请按 taskId 调用查询接口。

未省略结果时,通知中的 task 与单任务查询使用相同结构,包括 content、sources、products、videos、media、reasoningProcess 和 searchProcess。富媒体数组使用统一的全局 position 顺序。