Fecify-商家端task-详细

接口信息

  • 接口地址: {your-site-url}/api/skill/manager-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/manager-task/info?task_id=1373' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "id": 1373,
        "shop_id": 15,
        "name": "批量翻译数据",
        "user_id": 1,
        "type": 1,
        "status": 3,
        "data": {
            "language_type": 1,
            "language_codes": [],
            "product": {"enable": false},
            "blog_article": {
                "enable": true,
                "force_type": true,
                "blog_type": 2,
                "blog_ids": [301, 302]
            }
        },
        "progress": {
            "translate_blog_article": {
                "title": {"cn": "翻译博客文章"},
                "total": 2,
                "progress": 2
            }
        },
        "plan_at": "2025-04-23 15:10:28",
        "begin_at": "2025-04-23 15:10:52",
        "end_at": "2025-04-23 15:11:04",
        "note": null,
        "updated_at": "2025-04-23 15:10:28",
        "created_at": "2025-04-23 15:10:28"
    },
    "message": "success"
}

返回字段说明

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

data 子字段

字段 类型 说明
id Number Task 唯一 ID
shop_id Number 所属店铺 ID
name String Task 任务名称
user_id Number 发起用户 ID
type Number 任务类型，对应 Fecify-商家端task-类型列表 中的 code
status Number 任务状态，对应 Fecify-商家端task-状态列表 中的 code
data Object Task 任务数据，内容因任务类型而异（如批量翻译时包含语言类型、翻译目标等）
progress Object Task 处理进度数据，键名为进度项标识，包含 title（多语言标题）、total、progress
plan_at String 计划执行时间，格式 YYYY-MM-DD HH:mm:ss
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 ""