Fecify-商家端task-列表

接口信息

  • 接口地址: {your-site-url}/api/skill/manager-task/list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取商家端异步任务(Task)列表,支持按类型和状态筛选,分页查询。与服务端 Task 列表不同,返回数据中包含关联店铺信息。

认证

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

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

请求参数

参数 类型 必填 说明
pageNum Number 页码,默认 1
pageSize Number 每页条数,默认 20
type Number Task 类型 ID,对应 Fecify-商家端task-类型列表 中的 code
status Number Task 状态 ID,对应 Fecify-商家端task-状态列表 中的 code

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/manager-task/list?pageNum=1&pageSize=20&type=1&status=3' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 2093,
                "shop_id": 15,
                "user_id": 1,
                "name": "AI商品标题生成",
                "status": 3,
                "type": 29,
                "begin_at": "2026-07-17 16:37:27",
                "end_at": "2026-07-17 16:37:32",
                "created_at": "2026-07-17 16:36:59",
                "updated_at": "2026-07-17 16:36:59",
                "plan_at": "2026-07-17 16:36:59",
                "progress": {
                    "aiprodtitle": {
                        "title": {"cn": "ai product title"},
                        "total": 1,
                        "progress": "1"
                    }
                },
                "shop": {
                    "id": 15,
                    "type": 10,
                    "name": "fec测试店铺-frist",
                    "https": 1,
                    "domain": "diydomain.fecmall.cn"
                }
            }
        ],
        "total": 2071,
        "pageSize": 20,
        "totalPage": 104
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data Object 返回数据,包含 listtotalpageSizetotalPage

data 分页字段

字段 类型 说明
list Array Task 记录列表
total Number 总记录数
pageSize Number 每页条数
totalPage Number 总页数

list 子项

字段 类型 说明
id Number Task 唯一 ID,用于查询详情或停止任务
shop_id Number 所属店铺 ID
user_id Number 发起用户 ID
name String Task 任务名称
status Number 任务状态,对应 Fecify-商家端task-状态列表 中的 code
type Number 任务类型,对应 Fecify-商家端task-类型列表 中的 code
begin_at String / Number 执行开始时间,0 表示尚未开始
end_at String / Number 执行结束时间,0 表示尚未结束
plan_at String 计划执行时间,格式 YYYY-MM-DD HH:mm:ss
created_at String 创建时间
updated_at String 最后更新时间
progress Object 任务处理进度数据,键名为进度项标识,包含 title(多语言标题)、totalprogress
shop Object / Null 关联店铺信息,全局任务时为 null

shop 子字段

字段 类型 说明
id Number 店铺 ID
type Number 店铺类型
name String 店铺名称
https Number 是否启用 HTTPS:1 = 是
domain String 店铺域名

注意事项

  1. typestatus 为可选筛选参数,不传则返回全部。
  2. type 值从 Fecify-商家端task-类型列表 获取,status 值从 Fecify-商家端task-状态列表 获取。
  3. 完整 Task 详情(含 datanote)需通过 Fecify-商家端task-详细 获取。

results matching ""

    No results matching ""