API 参考

Webhook 端点

删除 Webhook 端点

删除一个 Webhook 端点。删除成功不返回响应体。

DELETEhttps://api.unifyport.ai/v1/webhook-endpoints/{endpoint_id}

调用前准备

在服务端使用资源所属工作区的 X-Api-Key。运行示例前替换所有占位符。

请求参数

请求头

X-Api-Key
string必填

工作区 API Key，工作区由该请求头解析得到。

路径参数

endpoint_id
string必填

用于该 webhook endpoints 路由的标识符。

请求体

该接口无需 JSON 请求体。

如何理解结果

配置成功不代表事件已投递。触发相关事件，在接收端确认收到请求、验签通过并正确响应。

响应 204 No Content

无响应体。

响应

204

204 No Content

请求成功，无响应体。

400

请求错误

请求体、路径或参数不合法。

401

未授权

X-Api-Key 请求头缺失或无效。

失败后怎么处理

检查 HTTP 状态和 error.code/numeric_code，保存 request_id 用于排查。按原因修正参数、继续授权或检查运行态。重试发送及其他写操作前先确认上一次结果，避免重复操作。 错误码参考

invalid_request · 10000 · 400
检查必填字段、格式和渠道条件，修正请求后再调用。
invalid_api_key · 11001 · 401
检查 X-Api-Key 是否正确、工作区是否有效。