查询待打印任务数量

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

第三方平台通过调用查询待打印任务数量接口(/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

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