第三方平台通过调用查询打印中订单接口(/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