导出运行结果

方法: GET

端点: /api/v2/worker-runs/{runId}/result/export

认证: 支持 Authorization: Bearer <YOUR_API_KEY>、api-key: <YOUR_API_KEY> 和 ?token=<YOUR_API_KEY>。推荐优先使用 Bearer token。

在线试用

GET/api/v2/worker-runs/{runId}/result/exportExport worker run results

AuthenticationRequired

Auth mode

Authorization: Bearerapi-key headerQuery token

API token

Stored only in this browser tab. Sent only to https://openapi.coreclaw.com.

Parameters

runIdpath · stringRequired

Run slug returned as `data.run_slug` from start or rerun responses.

formatquery · string · default `csv`Optional

Export format. Constraints: default `csv`.

filter_keysquery · stringOptional

Comma-separated field keys used to limit exported fields, for example `title,address`.

Request BodyNot applicable

No JSON request body. Fill the path or query parameters above.

Send Request Clear all

什么时候使用这个接口

用于把运行结果导出为文件下载地址。

标识符说明

• runId 是运行记录 slug。启动或重跑后的 data.run_slug 就是后续接口使用的 runId。

路径参数

参数	必填	类型	说明
runId	是	string	运行记录 slug，即启动或重跑响应中的 data.run_slug。

查询参数

参数	必填	类型	说明
format	否	string	导出格式。当前默认 csv。 约束：默认 csv。
filter_keys	否	string	逗号分隔的字段名列表，用于限制导出字段，例如 title,address。

请求示例

curl -X GET "https://openapi.coreclaw.com/api/v2/worker-runs/YOUR_RUN_ID/result/export?format=csv&filter_keys=title%2Caddress" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "code": 0,
  "data": {
    "download_url": "https://storage.example.com/runs/01KKDXV2G26BT7NH4ZQR2R4NPZ/results.csv"
  },
  "message": "success",
  "request_id": "req-123"
}

注意事项

• API v2 同时支持 Bearer token、旧版 api-key 请求头和 query token；新集成建议优先使用 Bearer token。
• filter_keys 可用于限制导出字段，例如 title,address。
• 结果列表使用 offset 和 limit 分页。

HTTP 响应

HTTP 状态	应用代码	含义
200	0	请求成功。
400	11000	请求参数不合法。
401	12001	认证缺失或无效。
404	11004	目标资源不存在。
422	11000	请求语义或字段校验未通过。
429	13000	请求过于频繁。
500	10000	服务端内部错误。