You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
Webhooks
发送 Webhook 测试事件
复制全文
下载 pdf
发送 Webhook 测试事件
POST https://ark.cn-beijing.volces.com/api/v3/webhook_endpoints/{endpoint_id}/test​
生成并异步投递一个 webhook.test 测试事件。启用和停用状态下均可调用,测试事件不受订阅事件列表过滤。​
接口返回 200 表示测试事件已生成并受理,不表示回调地址已经收到事件。测试事件只尝试投递一次;普通接收失败不改变接入点状态,不更新业务投递统计,也不会自动启用接入点。​
每次调用都会生成新的测试事件。请求超时后直接重试可能导致接收端收到多个不同事件 ID 的测试通知。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
​​
请求参数​
Path 参数​
endpoint_id string 必选 | 接入点 ID​
​
​
响应参数​
created_at string | 生成时间​
​
data object | 事件数据​
​
id string | 事件 ID​
​
type string | 对象类型​
​
​

Request

curl -sS --fail-with-body -X POST \
  "https://ark.cn-beijing.volces.com/api/v3/webhook_endpoints/$WEBHOOK_ENDPOINT_ID/test" \
  -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": "webhook.test",
    "id": "wep-20261012080000-a1b2c"
  }
}
最近更新时间:2026.10.28 11:37:21
这个页面对您有帮助吗?
有用
有用
无用
无用