重新投递 Webhook

接口说明

通过 deliveryId 请求重新投递一条 Webhook 投递记录。

接口信息

字段	值
方法	POST
路径	/openapi/v2/webhook-deliveries/{deliveryId}/redeliver
Operation ID	redeliverWebhook
鉴权	Bearer OpenAPI key

入参

名称	位置	必填	类型	示例	说明
deliveryId	path	是	string	delivery-11111111-1111-4111-8111-111111111111	Webhook 投递列表 API 返回的投递标识。

请求体

这个接口没有请求体。

请求示例

curl -X POST "https://openapi.example.com/openapi/v2/webhook-deliveries/delivery-11111111-1111-4111-8111-111111111111/redeliver" \
  -H "Authorization: Bearer <openapi-key>"

成功响应

202

返回根据指定投递记录创建的新投递尝试。

字段	必填	类型	说明
delivery	是	object	Webhook 投递记录。

成功响应示例

{
  "delivery": {
    "deliveryId": "delivery-22222222-2222-4222-8222-222222222222",
    "webhookId": "webhook-11111111-1111-4111-8111-111111111111",
    "eventId": "event-11111111-1111-4111-8111-111111111111",
    "eventType": "document.available",
    "payload": {
      "knowledgeBaseId": "knowledge-base-11111111-1111-4111-8111-111111111111",
      "operationId": "document-operation-11111111-1111-4111-8111-111111111111",
      "sourceFileId": "source-file-11111111-1111-4111-8111-111111111111",
      "state": "available",
      "errorCode": null,
      "occurredAt": "2026-06-17T00:00:00.000Z"
    },
    "status": "pending",
    "attemptCount": 0,
    "httpStatus": null,
    "errorCode": null,
    "createdAt": "2026-06-17T00:00:00.000Z",
    "updatedAt": "2026-06-17T00:00:00.000Z"
  }
}

错误码

下表列出这个接口已声明的全部错误响应。

HTTP 状态	错误码	说明
401	UNAUTHORIZED	Bearer API key 缺失、格式错误、未知、已撤销或已删除。
404	NOT_FOUND	请求的资源不存在。
409	CONFLICT	请求与资源当前状态冲突。
429	RATE_LIMITED	请求超过当前配置的速率限制。
500	INTERNAL_ERROR	API 遇到内部错误。
503	DATABASE_REPOSITORY_UNAVAILABLE	当前接口所需的数据暂时不可用。

后续操作

• 列出投递记录