§ API REFERENCE

撤销 Webhook订阅

DELETE/webhook-endpoints/{subscription_id}scope: webhook:manage

幂等撤销并软删除当前 APP 的订阅。

鉴权：Authorization: Bearer <access_token>。

§ 1

请求信息

REQUEST

DELETE https://api.lingxiguangnian.com/api/open/v1/webhook-endpoints/{subscription_id}

请求头

参数	类型	必填	说明
`Authorization`	string	是	Bearer <access_token>。由 POST /token 换取，有效期 2 小时；api_secret 不得直连业务端点（→ 401）。

路径参数

参数	类型	必填	说明
`subscription_id`	uuid	是	订阅ID。

§ 2

调用示例

EXAMPLES

DELETE /webhook-endpoints/{subscription_id}

curl -X DELETE "https://api.lingxiguangnian.com/api/open/v1/webhook-endpoints/11111111-1111-4111-8111-111111111111" -H "Authorization: Bearer oat_xxxxxxxxxxxxxxxx"

§ 3

返回结果

RESPONSE

返回字段

参数	类型	必填	说明
`id`	uuid	是	已撤销订阅ID。

RESPONSE · JSON

{ "success": true, "data": { "id": "11111111-1111-4111-8111-111111111111" } }

§ 4

端点错误码

ERRORS

通用鉴权、scope 与限流错误见「使用概述」；下表为本端点专属错误。

HTTP	error_code	触发条件
404	`open_api.webhook_not_found`	订阅不存在或不属于当前 APP/机构。

契约真源：apps/m-master/src/app/api/open/v1/webhook-endpoints/[subscriptionId]/route.ts