测试 Webhook

POST 
/webhooks/:destination_id/test

向该 Webhook 发送一条带签名的 notification.test 事件，以验证连通性和你的签名检查。当你的端点在 10 秒内返回 2xx 时，返回 {"status": "sent"}。

每个账户每小时最多 5 次测试，与工作台中的 发送测试 按钮共用。

请求

Responses

200

测试通知已发送。

404

not_found——你的账户下没有该 Webhook。

422

校验错误

429

测试过于频繁——上限为每个账户每小时 5 次（与工作台共用）。响应体是纯字符串 detail，而不是结构化错误信封。

502

delivery_failed——测试通知无法投递到你的端点：非 2xx 响应、10 秒内无应答、重定向、连接错误，或该 URL 不再只解析到公网 IP 地址。