列出 Work - Qoder

GET /api/v1/cloud/environments/{environment_id}/work 列出 self_hosted Environment 下的 work items。结果使用游标分页，并按 ID 升序返回；该顺序等同于队列创建顺序。

路径参数

参数	类型	说明
`environment_id`	string	Environment ID，前缀为 `env_`

请求头

头部	必选	说明
`Authorization`	是	`Bearer $QODER_ACCESS_TOKEN`

查询参数

参数	类型	必选	默认值	说明
`limit`	integer	否	20	每页返回数量，范围 1-100；超过 100 返回 `400 invalid_request_error`
`page`	string	否	-	上一次响应 `next_page` 返回的游标
`before_id`	string	否	-	返回该 work item ID 之前的记录
`after_id`	string	否	-	返回该 work item ID 之后的记录

page、before_id 和 after_id 不能同时使用。完整分页规范详见分页。

示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/environments/env_019e64e01a137caf953ac2ac7b42ec5c/work?limit=2" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK

{
  "data": [
    {
      "id": "work_019f3be4fd2475d9a784bf2c739e1194",
      "type": "work",
      "environment_id": "env_019e64e01a137caf953ac2ac7b42ec5c",
      "data": {
        "type": "session",
        "id": "sess_019f3be3fa66750bb9a1fbcde85b5fe1"
      },
      "state": "queued",
      "created_at": "2026-07-01T08:15:01Z",
      "acknowledged_at": null,
      "started_at": null,
      "latest_heartbeat_at": null,
      "stop_requested_at": null,
      "stopped_at": null,
      "metadata": {
        "job": "daily-report"
      }
    }
  ],
  "first_id": "work_019f3be4fd2475d9a784bf2c739e1194",
  "last_id": "work_019f3be4fd2475d9a784bf2c739e1194",
  "has_more": false,
  "next_page": null
}

响应字段

字段	类型	说明
`data`	Work item 对象数组	当前页的 work items
`first_id`	string\|null	当前页第一条记录的 ID
`last_id`	string\|null	当前页最后一条记录的 ID
`has_more`	boolean	是否还有更多数据
`next_page`	string\|null	下一页游标。`has_more` 为 true 时等于 `last_id`，否则为 `null`

错误码

HTTP	type	触发条件
400	`invalid_request_error`	`limit` 不是正整数
400	`invalid_request_error`	同时传入了 `page`、`before_id`、`after_id` 中的多个参数
400	`invalid_request_error`	Environment 不是 `self_hosted`
401	`authentication_error`	PAT 或 SAT 无效或过期
403	`permission_error`	无权限执行此操作
404	`not_found_error`	Environment 不存在

完整错误信封格式见错误参考。

云端环境

选择 Agent 运行的容器、网络与依赖。

​路径参数

​请求头

​查询参数

​示例请求

​示例响应

​响应字段

​错误码

​相关