文档中心

火山方舟

Webhooks

查询 Webhook 事件列表

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

查询指定 Webhook 接入点在最近 7 天内关联的事件信封。列表按事件发生时间倒序排列，支持按事件 ID 或事件类型精确筛选。

事件重试不会产生重复列表项。查询结果来自投递时保存的冻结信封，不会重新读取业务资源，也不包含投递状态或逐次重试明细。

接入点停用后仍可查询。删除接入点后，在 7 天墓碑保留期内仍可查询尚未过期的关联事件。

鉴权

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

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

请求参数

Path 参数

endpoint_id string 必选 | 接入点 ID

Query 参数

在 URL Query String 中传入。

event_id string | 事件 ID 筛选

event_type string | 事件类型筛选

limit integer 默认值 20 | 每页事件数

page string | 下一页标识

响应参数

data object[] | Webhook 事件列表

next_page string / null | 下一页标识

查询 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?limit=20&event_type=session.status_idled" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

HTTP/1.1 200 OK

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

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

这个页面对您有帮助吗？

有用

无用