查询某 Worker 最近一次运行结果

方法: GET

端点: /api/v2/workers/{workerId}/runs/last/result

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

在线试用

GET/api/v2/workers/{workerId}/runs/last/resultList worker last run results

AuthenticationRequired

Auth mode

API token

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

Parameters

workerIdpath · stringRequired

Worker slug or path. You may paste `owner/name`; the playground sends it as `owner~name` for path values. The playground prefills an official Worker (`coreclaw/google-maps-scraper`); replace it with your own.

offsetquery · integer · default `1`; minimum 0Optional

Page number, 1-based. `offset=1` is page 1, `offset=2` is page 2; `offset=0` is accepted as page 1. Out-of-range pages return an empty list. Constraints: default `1`; minimum 0.

limitquery · integer · default `20`; range 1-100Optional

Page size. Constraints: default `20`; range 1-100.

Request BodyNot applicable

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

什么时候使用这个接口

用于分页读取运行结果行，适合结果预览和表格展示。

标识符说明

workerId / worker_id 支持 Worker slug，也支持把路径 owner/name 写成 owner~name。

路径参数

参数	必填	类型	说明
`workerId`	是	`string`	Worker slug 或 path；如果使用 `owner/name` 路径，请写成 `owner~name`。

查询参数

参数	必填	类型	说明
`offset`	否	`integer`	页码，从 1 开始。`offset=1` 为第 1 页，`offset=2` 为第 2 页；`offset=0` 兼容作为第 1 页。超出总页数时返回空列表。约束：默认 `1`；最小 0。
`limit`	否	`integer`	每页返回数量；列表和结果接口的 `limit` 上限为 `100`。约束：默认 `20`；范围 1-100。

请求示例

curl -X GET "https://openapi.coreclaw.com/api/v2/workers/YOUR_WORKER_ID/runs/last/result?offset=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "code": 0,
  "data": {
    "count": 1,
    "headers": [
      {
        "key": "title",
        "label": "Title"
      }
    ],
    "list": [
      {
        "title": "Example result"
      }
    ],
    "page_index": 1,
    "page_size": 20
  },
  "message": "success",
  "request_id": "req-123"
}

响应字段

字段	类型	说明
`data.count`	`integer`	当前运行的结果总行数。
`data.headers[]`	`array`	列定义，每项包含 `key`（字段名）和 `label`（展示名）。
`data.list[]`	`array`	结果数据行；每行的键对应 `headers[].key`。

结果行可能包含未在 Worker 输出 schema 中声明的内部字段（例如 __coreclaw_data_id__），请按需忽略。嵌套或空值的序列化方式取决于导出格式；filter_keys 必须匹配 headers[].key。分页请求使用从 1 开始的 offset（页码）与 limit（最大 100）。

注意事项

API v2 同时支持 Bearer token、旧版 api-key 请求头和 query token；新集成建议优先使用 Bearer token。
这是 Worker 级最近运行接口，workerId 是必填路径参数；它只会作用于该 Worker 范围内最近一次运行。
last 表示当前筛选范围内最近一次运行；如需确定目标，请使用具体 runId 接口。
结果列表使用 offset 和 limit 分页。
offset 为从 1 开始的页码（offset=1 为第 1 页，offset=0 兼容作为第 1 页）；limit 默认 20，最大 100。
运行状态、轮询、失败诊断和取消处理请参阅运行生命周期与状态。

HTTP 响应

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