§ API REFERENCE

查询报告状态

GET/executions/{id}/reportscope: reports:read

查询某执行关联报告的生成状态（不返回明文 PII）。

鉴权：Authorization: Bearer <access_token>。

§ 1

请求信息

REQUEST

GET https://api.lingxiguangnian.com/api/open/v1/executions/{id}/report

请求头

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

路径参数

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

§ 2

调用示例

EXAMPLES

GET /executions/{id}/report

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

§ 3

返回结果

RESPONSE

返回字段

参数	类型	必填	说明
`report_status`	string	是	NOT_GENERATED / GENERATING / READY / FAILED / ARCHIVED。
`report_id`	uuid \| null	是	报告 ID（未生成为 null）。
`report_url`	string \| null	是	报告相对路径（仅 READY）。

RESPONSE · JSON

{ "success": true, "data": { "execution_id": "9b8e0c2a-3d4f-4a5b-8c6d-7e8f9a0b1c2d", "report_status": "READY", "report_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f", "report_url": "/resource/reports/c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f" } }

§ 4

端点错误码

ERRORS

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

HTTP	error_code	触发条件
404	`open_api.execution_not_found`	执行不存在或不属本 APP。

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