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}'
返回结果
code 为 200 表示调用成功;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 |
子流程已经处理完成的数据数量 |
注意事项
data 为 Task 提交时的输入参数,不同 Task 类型结构不同
note 为 Task 执行的输出日志,当 Task 执行错误时此字段可能包含错误信息
progress 用于展示各个子流程的执行进度