Skip to main content

任务报表汇总

获取指定时间段内的任务数据

接口URL​

POST: {base_url}/openapi/tasks-report

Headers​

参数参数说明
AuthorizationBearer <API令牌>

请求参数​

参数类型必填参数说明示例
created_fromString创建任务时间范围-开始，ISO-8601格式：YYYY-MM-DDTHH:mm:ss.sssZ如：2025-10-31T16:00:00.000Z为东八区25-11-01 00:00:00
created_toString创建任务时间范围-结束，ISO-8601格式：YYYY-MM-DDTHH:mm:ss.sssZ如：2025-11-30T16:00:00.000Z为东八区25-12-01 00:00:00

请求示例​

获取11月份的数据

{
    "startDate": "2025-10-31T16:00:00.000Z",
    "endDate": "2025-11-30T16:00:00.000Z"
}

响应示例​

成功

{
    "code": 0,
    "timestamp": 1763560725,
    "data": {
        "tasks": [
            {
                "id": "66c0aeae34", // 任务ID
                "file_name": "XXXXX", // 任务名称
                "total_items": 175, // 商品总数
                "status": "未开始", // 任务当前状态: "完成", "未开始", "抓取中", "暂停", "失败", "删除"
                "created_at": "2025/11/01 16:57:36", // 任务创建时间(已转成北京时区)
                "start_at": null, // 任务开始时间
                "completed_at": null, // 任务完成时间
                "user_email": "[email protected]", // 任务创建者
                "created_src": "website",
                "remark": null, // 备注
                "is_deleted": 0,
                "completedCount": 0, // 抓取成功数
                "disabledCount": 0, // 下架/失效/无货数
                "failedCount": 0 // 异常数
            }
        ]
    }
}

异常数据结构示例

{
    "code": 401,
    "msg": "身份验证失败: 无效的API令牌",
    "timestamp": 1755074441
}