Fecify-服务端task-详细

接口信息

  • 接口地址: {your-site-url}/api/skill/task/info
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 根据 Task ID 获取服务端后台异步任务的完整详情，包括任务参数、进度、执行时间等。

认证

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

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数

参数 类型 必填 说明
task_id Number 是 Task ID（Query 参数），从 Fecify-服务端task-列表 获取

请求示例

cURL

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

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "id": 1927,
        "shop_id": 0,
        "name": "店铺复制-(从 Grey暗黑风格模版(id：272) 同步到 grey 复制测试tag(id：344)",
        "user_id": 0,
        "type": 8,
        "status": 3,
        "data": {
            "source_shop_id": "272",
            "is_copy_blog": 1,
            "is_copy_menu": 1,
            "is_copy_page": 1,
            "is_copy_product": 1,
            "is_copy_theme": 1,
            "is_copy_site_lang": 1,
            "is_copy_notice": 1,
            "is_copy_attachment": 1,
            "is_copy_addons": 1,
            "is_copy_currency": 1,
            "is_copy_language": 1,
            "is_copy_shop_setting": 1,
            "target_shop_id": 344
        },
        "progress": [],
        "plan_at": 1766748067,
        "begin_at": "2025-12-26 19:21:28",
        "end_at": "2025-12-26 19:22:16",
        "note": null,
        "updated_at": "2025-12-26 19:21:07",
        "created_at": "2025-12-26 19:21:07"
    },
    "message": "success"
}

返回字段说明

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

data 子字段

字段 类型 说明
id Number Task 唯一 ID
shop_id Number 所属店铺 ID，0 为全局任务
name String Task 任务名称
user_id Number 发起用户 ID
type Number 任务类型，对应 Fecify-服务端task-类型列表 中的 code
status Number 任务状态，对应 Fecify-服务端task-状态列表 中的 code
data Object Task 任务数据，内容因任务类型而异（如店铺复制时包含源/目标店铺 ID 和复制选项）
progress Array Task 处理进度数据
plan_at Number 计划执行时间（Unix 时间戳）
begin_at String 实际执行开始时间，格式 YYYY-MM-DD HH:mm:ss
end_at String 实际执行结束时间，格式 YYYY-MM-DD HH:mm:ss
note String / Null 任务备注信息，无备注时为 null
created_at String 创建时间
updated_at String 最后更新时间

注意事项

  1. task_id 通过 Fecify-服务端task-列表 获取。
  2. data 字段内容因 type 不同而结构不同，示例为店铺复制类型的数据。
  3. 状态为 2（处理中）的 Task 可通过 Fecify-服务端task-停止task 手动终止。

results matching ""

    No results matching ""