§ API REFERENCE

取消执行并释放点数

POST/executions/{id}/cancelscope: executions:write

取消仍为 RUNNING 的执行、撤销其免登入口并释放已冻结点数；重复取消幂等。

鉴权：Authorization: Bearer <access_token>。

§ 1

请求信息

REQUEST

POST https://api.lingxiguangnian.com/api/open/v1/executions/{id}/cancel

请求头

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

路径参数

参数	类型	必填	说明
`id`	uuid	是	执行 ID。

§ 2

调用示例

EXAMPLES

POST /executions/{id}/cancel

curl -X POST "https://api.lingxiguangnian.com/api/open/v1/executions/9b8e0c2a-3d4f-4a5b-8c6d-7e8f9a0b1c2d/cancel" \
  -H "Authorization: Bearer oat_xxxxxxxxxxxxxxxx"

§ 3

返回结果

RESPONSE

返回字段

参数	类型	必填	说明
`execution_id`	uuid	是	执行 ID。
`status`	string	是	固定 CANCELLED。
`replayed`	boolean	是	true 表示此前已取消，本次未重复释放。

RESPONSE · JSON

{ "success": true, "data": { "execution_id": "9b8e0c2a-3d4f-4a5b-8c6d-7e8f9a0b1c2d", "status": "CANCELLED", "replayed": false } }

§ 4

端点错误码

ERRORS

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

HTTP	error_code	触发条件
404	`open_api.execution_not_found`	执行不存在或不属本 APP。
409	`open_api.invalid_status_transition`	执行已完成、失败或被拒绝，不能取消。

使用说明

仅取消未完成执行；成功后 settlement_status=RELEASED，重复请求不会重复写账。

契约真源：apps/m-master/src/app/api/open/v1/executions/[id]/cancel/route.ts