第三方平台通过调用查询待打印任务数量接口(/api/printer/getTaskCount),向开放平台查询指定打印机当前待打印的订单数量,统计范围包含正在打印中的任务;支持通过可选参数 channel 查询指定货道的库存数量,用于前端队列展示与自助机货道管理。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | https://www.colorpark.cn/api/printer/getTaskCount |
| 请求方式 | POST |
请求参数
| 参数名 | 参数值(示例) | 数据类型 | 必填项 | 参数说明 |
|---|---|---|---|---|
| printer_id | 500001 | string | 是 | 打印机分配的唯一 ID 号,每一台打印都会分配一个不同的编号 |
| once | 8305 | string | 是 | 加密生成签名时使用的随机数值 |
| time | 1646790335 | string | 是 | 加密生成签名时使用的时间戳 |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | 是 | 生成的签名,生成方式请参考《底层方法【基础支撑】》生成签名章节 |
| channel | 1 | string | 否 | 非必填,不填写返回所有货道数据,填写货道返回具体的货道数量 |
返回结果
| 字段 | 数据类型 | 参数值(示例) | 参数说明 |
|---|---|---|---|
| code | string | 0 | 返回结果状态码,成功时为 0,失败时为 1 |
| msg | string | Success | 返回结果描述,如:Success |
| data.count | string | 1 | 排队任务数量(包括正在打印中的任务,打印中的任务参与数量统计) |
| data.channel | list | [{"channel":1","stock_quantity":10}] |
channel:货道,stock_quantity:库存数量 |
注:原文
data.channel示例值[{"channel":1","stock_quantity":10}]中键名channel的引号疑似缺失(应为{"channel":"1"...}或{"channel":1...}),如实保留。
若设备在调试过程中遇到不能解决问题,可以联系云打印负责人排除问题,找到解决的方法。联系方法如下: 电 话:137-5177-4454【微信同号】 邮 箱:info@ColorPark.cn