批量查询任务

批量查询当前 API Key 所属用户的异步任务，获取执行状态、输入参数、输出结果与错误信息。

v1查询接口 Bearer 鉴权

POSThttps://popto.cn/api/open/v1/task/batch_get

鉴权与请求头

在 API 密钥管理 ↗ 创建密钥，每次请求在 HTTP Header 中携带。

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typeapplication/json必填

请求参数 Body · JSON

task_idsstring[]必填

任务 ID 数组，去除空白、空字符串和重复项后需为 1–50 个。

返回值与结构

成功时 ret = 0，业务数据位于 data.ent。以下为 data.ent 中的字段。

listobject[]

按请求顺序返回当前用户拥有的任务。不存在或无权限的任务会被省略。

查看数组元素字段 19

idinteger

任务记录 ID。

task_idstring

任务 ID。

task_typestring

任务类型。

task_scenestring

任务场景。

source_idstring

关联的工具或工作流 ID。

statusstring

任务状态。

可选值 pendingrunningsuccessfailedcancelled

priorityinteger

任务优先级，数字越小优先级越高。

timeout_secondsinteger

任务超时时间，秒。

ownerstring

任务所属用户标识；只能查询当前用户的任务。

project_idstring

关联项目 ID。

inputsJSON

任务输入，JSON 对象、数组或 null。

outputsJSON

任务结果，JSON 值或 null；success 时读取。

error_msgJSON

任务错误详情，JSON 值或 null。

retry_countinteger

已重试次数。

max_retryinteger

最大重试次数。

start_timeinteger

开始时间，Unix 秒。

finish_timeinteger

结束时间，Unix 秒。

ctinteger

创建时间，Unix 秒。

utinteger

更新时间，Unix 秒。

调用说明

pending、running 表示执行中；success 表示完成；failed、cancelled 表示终止。建议间隔 3–5 秒轮询，并设置总超时。
HTTP 200 或 ret=0 不等于任务完成，应继续检查每条任务的 status。
inputs、outputs、error_msg 由服务端解码为 JSON。兼容旧结果时，可对字符串值再执行 JSON.parse。

处理业务响应

HTTP 200 仍可能返回业务错误，请同时检查 ret、code 和 msg。查看响应与错误码

请求示例Request

bash

curl --request POST \
  'https://popto.cn/api/open/v1/task/batch_get' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "task_ids": [
    "task_example"
  ]
}'

成功响应200 OK

json

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "list": [
        {
          "task_id": "task_example",
          "status": "running",
          "inputs": {
            "url": "https://v.douyin.com/VIDEO_SHARE_CODE/",
            "split_video": false
          },
          "outputs": null,
          "error_msg": null
        }
      ]
    }
  }
}

示例内容用于说明结构。任务 ID、积分和执行结果以实际响应为准。