查询所有任务

最后更新：2026-09-22 16:08:28

查询所有任务，第三方平台可通过调用接口，向开放平台查询任务的详细信息，平台将同步返回相关的任务及订单状态。

接口信息

项目 值
接口地址 https://www.colorpark.cn/api/task/getTaskList
请求方式 POST

请求参数

参数名 参数值（示例） 数据类型 必填项 参数说明
printer_id 500001 string 是 打印机分配的唯一 ID 号，每一台打印都会分配一个不同的编号
once 8305 string 是 加密生成签名时使用的随机数值
time 1646790335 string 是 加密生成签名时使用的时间戳
sign 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c string 是 生成的签名，生成方式请参考《底层方法【基础支撑】》生成签名章节
page 1 string 是 当前页码
page_size 10 string 是 每页条数
exclude_status 0,1 string 否 除某些状态(逗号隔开)的所有任务 0:等待打印 1:正在打印 2:完成打印 3:取消打印 4:打印故障
status 0,1 string 否 某些状态(逗号隔开)的所有任务 0:等待打印 1:正在打印 2:完成打印 3:取消打印 4:打印故障

返回结果

字段 数据类型 参数值（示例） 参数说明
code string 0 返回结果状态码，成功时为 0，失败时为 1
msg string 获取成功 返回结果描述，如：获取成功
data.total string 5548 当前条件任务总数量
data.page int 1 当前页码
data.page_size int 10 每页条数
data.total_pages int 555 总页数
data.list array [{}] 任务数据 
{
"code": 0,
"msg": "获取成功",
"data": {
    "total": 5548,
    "page": 1,
    "page_size": 10,
    "total_pages": 555,
    "list": [
        {
            "id": 20485384,//任务ID
            "taskid": 20485384,
            "printer_id": 1000929,//设备编号
            "order_id": "164679033555822",//订单编号
            "name": "手机壳",
            "file": "https://abc.colorpark.cn/1684505_17575600957909.png",//图片地址
            "file_bgc": "",
            "status": 2,//设备状态 0:等待打印 1:正在打印 2:完成打印 3:取消打印 4:打印故障
            "template_id": 1,
            "task_type": 0,
            "white_ink": 1,//是否打印白墨
            "ink_mode": -1,
            "ink_item": [],
            "callback": "http://www.abc.com/api/callback",//任务回调地址
            "is_merge": 0,
            "unique": "",
            "quantity": 1,
            "receive_status": 1,//接受状态
            "create_time": "2026-09-09 15:54:18",
            "start_time": 1788940460,
            "finish_time": 1788940550,
            "status_text": {
                "color": "green",
                "name": "打印完成"
            },
            "finish_time_format": "2026-09-09 15:55:50",
            "push_time_format": "",
            "received_time_format": "",
            "receive_status_time_format": "",
            "file_ext": "png",
            "ink_mode_text": "--"
        },
        {...},
        {...},
        {...},
        {...},
        {...},
        {...},
        {...},
        {...},
        {...}
    ]
}

若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下： 电 话：137-5177-4454【微信同号】 邮 箱：info@ColorPark.cn

软硬件深度整合的UV云打印服务商 ® 瑞丰彩