§ API REFERENCE

查询单次用量详情

GET/usage-records/{execution_id}scope: usage:read

读取当前 APP 单次 execution 的结算、释放、报告与安全失败码。

鉴权：Authorization: Bearer <access_token>。

§ 1

请求信息

REQUEST

GET https://api.lingxiguangnian.com/api/open/v1/usage-records/{execution_id}

请求头

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

路径参数

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

§ 2

调用示例

EXAMPLES

GET /usage-records/{execution_id}

curl "https://api.lingxiguangnian.com/api/open/v1/usage-records/9b8e0c2a-3d4f-4a5b-8c6d-7e8f9a0b1c2d" -H "Authorization: Bearer oat_xxxxxxxxxxxxxxxx"

§ 3

返回结果

RESPONSE

返回字段

参数	类型	必填	说明
`execution_id/status/resource_type/resource_id`	mixed	是	执行与资源身份。
`settlement_status/credit_amount/release_reason`	mixed	是	可证结算结果；不猜测未终结金额。
`report_id/report_kind/report_status/report_view_available`	mixed	是	报告元数据，不签发token。
`failure_code/failure_summary`	string \| null	是	仅安全错误码；无安全摘要来源时 summary 为 null。

RESPONSE · JSON

{ "success": true, "data": { "execution_id": "9b8e0c2a-3d4f-4a5b-8c6d-7e8f9a0b1c2d", "settlement_status": "SETTLED", "credit_amount": 5, "report_status": "READY" } }

§ 4

端点错误码

ERRORS

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

HTTP	error_code	触发条件
404	`open_api.execution_not_found`	执行不存在或不属于当前 APP/机构。
500	`open_api.usage_query_failed`	用量派生查询失败。

契约真源：apps/m-master/src/app/api/open/v1/usage-records/[executionId]/route.ts