Fecify-服务端task-列表

接口信息

  • 接口地址: {your-site-url}/api/skill/task/list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取服务端后台异步任务（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/task/list?pageNum=1&pageSize=20&type=8&status=3' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 1927,
                "shop_id": 0,
                "user_id": 0,
                "name": "店铺复制-(从 Grey暗黑风格模版(id：272) 同步到 grey 复制测试tag(id：344)",
                "status": 3,
                "type": 8,
                "begin_at": "2025-12-26 19:21:28",
                "end_at": "2025-12-26 19:22:16",
                "created_at": "2025-12-26 19:21:07",
                "updated_at": "2025-12-26 19:21:07",
                "progress": []
            }
        ],
        "total": 12,
        "pageSize": 20,
        "totalPage": 1
    },
    "message": "success"
}

返回字段说明

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

data 分页字段

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

list 子项

字段 类型 说明
id Number Task 唯一 ID，用于查询详情或停止任务
shop_id Number 所属店铺 ID，0 为全局任务
user_id Number 发起用户 ID
name String Task 任务名称
status Number 任务状态，对应 Fecify-服务端task-状态列表 中的 code
type Number 任务类型，对应 Fecify-服务端task-类型列表 中的 code
begin_at String 执行开始时间，格式 YYYY-MM-DD HH:mm:ss
end_at String 执行结束时间，格式 YYYY-MM-DD HH:mm:ss
created_at String 创建时间
updated_at String 最后更新时间
progress Array 任务处理进度数据

注意事项

  1. type 和 status 为可选筛选参数，不传则返回全部。
  2. type 值从 Fecify-服务端task-类型列表 获取，status 值从 Fecify-服务端task-状态列表 获取。
  3. 完整 Task 详情（含 data、plan_at、note）需通过 Fecify-服务端task-详细 获取。

results matching ""

    No results matching ""