Task-详细

接口信息

  • 接口地址: {your-site-url}/api/skill/task/info
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 此接口用于获取指定 Task 的详细信息,包括提交数据、执行进度和输出日志。

认证

请求头中需要携带 skill-access-token

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)

请求参数 (Query String)

字段 类型 必填 说明
task_id int Task 记录 ID

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/task/info?task_id=2063' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code200 表示调用成功;code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "id": 2063,
        "shop_id": 15,
        "name": "Simprosysapis",
        "user_id": 1,
        "type": 44,
        "status": 3,
        "data": {
            "product_type": 1,
            "product_value": ""
        },
        "progress": {
            "aiprodimageedit": {
                "title": {
                    "cn": "Simprosysapis",
                    "tw": "Simprosysapis",
                    "en": "Simprosysapis"
                },
                "total": 21,
                "progress": "21"
            }
        },
        "plan_at": "2026-05-20 14:15:43",
        "begin_at": "2026-05-20 14:21:47",
        "end_at": "2026-05-20 14:23:46",
        "note": null,
        "updated_at": "2026-05-20 14:15:43",
        "created_at": "2026-05-20 14:15:43"
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data Object Task 详情数据

data 字段

字段 类型 说明
id int Task 记录 ID
shop_id int 店铺 ID
name string Task 名称
user_id int 操作用户 ID
type int Task 类型 code,对应 Task-类型列表
status int Task 状态。1 = 初始状态,2 = 处理中,3 = 完成,4 = 处理错误,5 = 手动终止
data Object Task 提交时传入的执行数据。不同 Task 类型结构不同
progress Object 执行进度信息。每个子项(key)为一个子流程
plan_at string 计划执行时间
begin_at string 实际开始时间
end_at string 完成时间
note string/null Task 执行输出的日志信息。null 表示无日志
created_at string 创建时间
updated_at string 最后更新时间

progress 字段

progress 的每个子项(key)代表该 Task 的一个子流程:

字段 类型 说明
[key].title.cn string 子流程中文名称
[key].title.tw string 子流程繁体中文名称
[key].title.en string 子流程英文名称
[key].total int 子流程需要处理的数据总数
[key].progress string 子流程已经处理完成的数据数量

注意事项

  1. data 为 Task 提交时的输入参数,不同 Task 类型结构不同
  2. note 为 Task 执行的输出日志,当 Task 执行错误时此字段可能包含错误信息
  3. progress 用于展示各个子流程的执行进度
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-06-04 14:17:03

results matching ""

    No results matching ""