激活运行队列项

方法: POST

端点: /api/v2/run-queue/items/activate

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

在线试用

POST/api/v2/run-queue/items/activateActivate run queue items

AuthenticationRequired

Auth mode

Authorization: Bearerapi-key headerQuery token

API token

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

Request BodyRequiredapplication/json

FieldTypeRequiredDescription

queue_refsarrayRequiredQueue item IDs.

Request body (JSON)Reset to example

{ "queue_refs": [] }

Send Request Clear all

什么时候使用这个接口

用于把停留在运行队列里的一个或多个运行真正启动起来。队列项默认进入 waiting 状态——比如提交运行时账户余额不足，运行会被暂时挂起而不是直接执行。等阻塞条件解决后（例如已充值补足余额），调用本接口即可开始执行。

请先调用 查询运行队列项 获取要激活项的 queue_ref。

请求体

使用 Content-Type: application/json 发送请求体。

字段	必填	类型	说明
queue_refs	是	array<string>	要激活的队列项 ID。从 查询运行队列项 返回的 queue_ref 复制。

JSON 示例

{
  "queue_refs": ["123456", "123457"]
}

请求示例

curl -X POST "https://openapi.coreclaw.com/api/v2/run-queue/items/activate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"queue_refs":["123456","123457"]}'

响应示例

{
  "code": 0,
  "data": {
    "results": [
      { "queue_ref": "123456", "success": true },
      { "queue_ref": "123457", "success": false }
    ]
  },
  "message": "success",
  "request_id": "req-123"
}

响应字段

字段	类型	说明
data.results[]	array	每个提交项的激活结果，一个 queue_ref 一条。
data.results[].queue_ref	string	该结果对应的队列项 ID。
data.results[].success	boolean	是否激活成功。当项已不在 waiting 状态（例如已执行或已释放）时为 false。

说明

• API v2 支持 Bearer token、旧版 api-key 请求头和 query token。新集成推荐使用 Bearer token。
• 该接口为批量操作：数组里的每个 queue_ref 都会在一次调用中激活。
• 如果你想把项从队列移除、不让它执行，请改用 释放运行队列项。
• 激活后，通过运行查询接口轮询运行状态、日志和结果，详见 运行生命周期与状态。

HTTP 响应

HTTP 状态码	应用码	含义
200	0	OK
400	11000	Bad Request
401	12001	Unauthorized
404	11004	Not Found
422	11000	Unprocessable Entity
429	13000	Too Many Requests
500	10000	Internal Server Error