获取运行详情

方法: GET

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

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

在线试用

GET/api/v2/worker-runs/{runId}Get worker run detail

AuthenticationRequired

Auth mode

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.

Request BodyNot applicable

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

什么时候使用这个接口

用于通过已知 runId 读取或操作某一次具体运行。

标识符说明

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

路径参数

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

请求示例

curl -X GET "https://openapi.coreclaw.com/api/v2/worker-runs/YOUR_RUN_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "code": 0,
  "data": {
    "duration": 10,
    "err_msg": "",
    "finished_at": 1782091210,
    "origin": "openapi",
    "results": 1,
    "scraper_slug": "demo-worker",
    "scraper_title": "Demo Worker",
    "slug": "01KKDXV2G26BT7NH4ZQR2R4NPZ",
    "started_at": 1782091200,
    "status": "running",
    "traffic": 0,
    "usage": "1.00",
    "version": "latest"
  },
  "message": "success",
  "request_id": "req-123"
}

响应字段

data 包含以下运行字段：

字段	类型	说明
`slug`	`string`	运行标识；作为后续详情、日志、结果和导出接口的 `runId`。
`scraper_slug`	`string`	实际运行的 Worker 标识。
`scraper_title`	`string`	Worker 展示名称。
`version`	`string`	实际运行的 Worker 版本，例如 `v1.2.8`。
`status`	`string`	运行状态，唯一的主要结果判断字段。取值见运行生命周期与状态。
`results`	`integer`	当前或最终结果行数。`0` 不代表失败。
`usage`	`string`	平台记录的资源用量（字符串数值），用于观测与计费诊断。
`traffic`	`integer`	平台记录的流量诊断值。
`origin`	`string`	运行来源，例如 `api_v2`。
`started_at`	`integer`	执行开始时间，Unix 秒。
`finished_at`	`integer`	执行结束时间，Unix 秒。
`duration`	`integer`	执行耗时，秒。
`err_msg`	`string`	可选诊断信息。可能缺失（例如成功运行时通常不返回该字段）；仅作辅助排障，不要单独用它判断成败。

时间戳为 Unix 秒（UTC）。取消、排队或状态同步时，时间字段可能出现不完整或不直观的组合；请始终以 status 为准。

注意事项

API v2 同时支持 Bearer token、旧版 api-key 请求头和 query token；新集成建议优先使用 Bearer token。
运行状态、轮询、失败诊断和取消处理请参阅运行生命周期与状态。

HTTP 响应

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