接入指南

完成通知

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

使用 PUT /v1/webhook 设置账户默认通知地址，也可以在创建执行时传入 webhookUrl。通知地址必须使用 HTTPS。

通知内容

{
  "event": "execution.completed",
  "deliveryRevision": 1,
  "execution": {
    "executionId": "00000000-0000-4000-8000-000000000001",
    "state": "completed",
    "itemCount": 1,
    "completedCount": 1,
    "failedCount": 0,
    "items": []
  }
}

请求头：

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

使用通知验签密钥，对原始请求字节计算 HMAC-SHA256。验签成功后尽快返回 HTTP 2xx，并按 X-Douzhi-Delivery 去重。

通知内容较大时，execution 会返回 resultsOmitted: true 和 resultsUrl，请再调用结果接口。