文档中心

火山方舟

Webhooks

查询 Webhook 事件详情

GET https://ark.cn-beijing.volces.com/api/v3/webhook_endpoints/{endpoint_id}/events/{event_id}

查询指定 Webhook 接入点在最近 7 天内关联的单个事件信封。响应是投递时保存的冻结信封，与回调请求体一致。

接口不返回投递状态或逐次重试明细，也不会重新读取业务资源。接入点停用后仍可查询；删除接入点后，在 7 天墓碑保留期内仍可查询尚未过期的关联事件。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

endpoint_id string 必选 | 接入点 ID

event_id string 必选 | 事件 ID

响应参数

created_at string | 发生时间

data object | 事件数据

id string | 事件 ID

type string | 对象类型

查询 Webhook 事件详情

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

#!/usr/bin/env bash
curl -sS --fail-with-body \
  "https://ark.cn-beijing.volces.com/api/v3/webhook_endpoints/$WEBHOOK_ENDPOINT_ID/events/$WEBHOOK_EVENT_ID" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

HTTP/1.1 200 OK

{
  "type": "event",
  "id": "whe-20261012080500-f6g7h",
  "created_at": "2026-10-12T08:05:00Z",
  "data": {
    "type": "session.status_idled",
    "id": "sesn-20261012080000-k1l2m"
  }
}

最近更新时间：2026.10.28 19:53:33

这个页面对您有帮助吗？

有用

无用