查询正在打印中的任务

最后更新:2026-09-22 16:08:26

第三方平台通过调用查询打印中订单接口(/api/task/getPrintingPrintTask),向开放平台发送指令查询指定打印机当前正处于打印中状态的订单列表,平台处理后将同步返回打印中订单的详细信息(如任务编号、订单号、商品名、图片 URL、状态等),用于实时监控设备当前正在执行的任务进度。

接口信息

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

请求参数

参数名 参数值(示例) 数据类型 必填项 参数说明
printer_id 500001 string 是 打印机分配的唯一 ID 号,每一台打印都会分配一个不同的编号
once 8305 string 是 加密生成签名时使用的随机数值
time 1646790335 string 是 加密生成签名时使用的时间戳
sign 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c string 是 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名章节

返回结果

字段 数据类型 参数值(示例) 参数说明
code string 0 返回结果状态码,成功时为 0,失败时为 1
msg string Success 返回结果描述,如:Success
data array [{}] 返回数据(数组)
data[].taskid string 20281112 打印任务的唯一编号
data[].order_id string 164679033555825 第三方平台的订单编号,由第三方平台生成,最大接受 32 位字符
data[].name string 珍珠奶茶 商品名称,如 珍珠奶茶,波霸奶茶
data[].file string https://img.colorpark.cn/render/2025/09/11/8125017/1684505_17575600957909.png 图片的 URL 地址
data[].file_bgc string https://img.colorpark.cn/render/2025/09/11/8125017/1684505_17575600957909.png 图片外框图 URL 地址
data[].status string 1 1:打印中
data[].white_ink string 0 0:不打白墨 1:白墨
data[].callback string http://www.abc.com/api/callback 甲方系统用于接收打印通知的回调地址,如开始打印通知、完成打印通知、取消打印通知、打印故障通知
data[].create_time string 2025-11-26 17:06:12 订单创建时间
data[].start_time string 2025-11-26 17:06:12 订单打印时间
data[].status_text string 打印中 订单打印状态:打印中

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

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