跳转到主要内容
GET /api/v1/cloud/environments/{environment_id}/work 列出 self_hosted Environment 下的 work items。结果使用游标分页,并按 ID 升序返回;该顺序等同于队列创建顺序。

路径参数

参数类型说明
environment_idstringEnvironment ID,前缀为 env_

请求头

头部必选说明
AuthorizationBearer $QODER_PAT

查询参数

参数类型必选默认值说明
limitinteger20每页返回数量,必须为正整数;超过 100 时按 100 处理
pagestring-上一次响应 next_page 返回的游标
before_idstring-返回该 work item ID 之前的记录
after_idstring-返回该 work item ID 之后的记录
pagebefore_idafter_id 不能同时使用。完整分页规范详见 分页

示例请求

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

示例响应

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
}

响应字段

字段类型说明
dataWork item 对象数组当前页的 work items
first_idstring|null当前页第一条记录的 ID
last_idstring|null当前页最后一条记录的 ID
has_moreboolean是否还有更多数据
next_pagestring|null下一页游标。has_more 为 true 时等于 last_id,否则为 null

错误码

HTTPtype触发条件
400invalid_request_errorlimit 不是正整数
400invalid_request_error同时传入了 pagebefore_idafter_id 中的多个参数
400invalid_request_errorEnvironment 不是 self_hosted
401authentication_errorPAT 无效或过期
403permission_error无权限执行此操作
404not_found_errorEnvironment 不存在
完整错误信封格式见 错误参考

相关

云端环境

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