Integration guide

Completion notifications

Receive one task completion notice and verify its signature.

Set the account default with PUT /v1/webhook, or pass webhookUrl in an individual task. Notification URLs must use HTTPS.

Each task sends its own logical notification:

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

Calculate HMAC-SHA256 over the raw request bytes with the notification secret. Return HTTP 2xx promptly. Network retries may repeat a delivery, so deduplicate by X-Douzhi-Delivery.

For a large result, task.resultOmitted is true; retrieve the full content with the task query endpoint.