第三方平台通过调用查询所有打印任务接口（/api/printer/getPrinterTask），向开放平台查询指定打印机下待打印、打印中的详细信息，平台同步返回相关的任务列表及订单状态数据，用于第三方平台展示、跟踪与管理全量打印任务生命周期。
接口信息
请求参数
| 参数名 |
参数值（示例） |
数据类型 |
必填项 |
参数说明 |
| printer_id |
500001 |
string |
是 |
打印机分配的唯一 ID 号，每一台打印都会分配一个不同的编号 |
| once |
8305 |
string |
是 |
加密生成签名时使用的随机数值 |
| time |
1646790335 |
string |
是 |
加密生成签名时使用的时间戳 |
| sign |
9ce3ce7a3fccaf3d7715bd7e9bb1dc1c |
string |
是 |
生成的签名，生成方式请参考《底层方法【基础支撑】》生成签名章节 |
返回结果
| 字段 |
数据类型 |
参数值（示例） |
参数说明 |
| code |
string |
0 |
返回结果状态码，成功时为 0，失败时为 1 |
| msg |
string |
提交成功 |
返回结果描述，如：提交成功 |
| data.taskid |
string |
20000196 |
打印任务的唯一编号 |
| data.printer_id |
string |
500001 |
打印机分配的唯一 ID 号，每一台打印都会分配一个不同的编号 |
| data.order_id |
string |
164679033555822 |
第三方平台的订单编号，由第三方平台生成，最大接受 32 位字符 |
| data.status |
string |
0 |
打印任务状态，0:等待打印 1:正在打印 |
| data.name |
string |
珍珠奶茶 |
商品名称，如 珍珠奶茶,波霸奶茶 |
| data.file |
string |
https://img.colorpark.cn/api/render/80301001651287933588.png |
图片的 URL 地址 |
| data.callback |
string |
http://www.abc.com/api/callback |
甲方系统用于接收打印通知的回调地址，如开始打印通知、完成打印通知、取消打印通知、打印故障通知 |
| data.create_time |
string |
2022-03-09 14:19:30 |
打印任务创建的时间 |
| data.start_time |
string |
2022-03-09 14:19:30 |
打印任务开始打印的时间 |
| data.finish_time |
string |
2022-03-09 14:19:30 |
打印任务完成打印的时间 |
若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下：
电 话：137-5177-4454【微信同号】
邮 箱：info@ColorPark.cn
软硬件深度整合的UV云打印服务商 ® 瑞丰彩
