打印机状态回调V2

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

打印机状态回调,根据代理商的以下应用场景配置相应回调地址,当打印机状态更新时,开放平台将实时推送任务信息至该地址,以便后续处理。

注:升级或安装最新版本的云打印客户端才可使用当前功能(可与官方技术团队确认客户端版本)

回调地址

接口地址示例 http://XXXX.com/api/callback 根据不同应用场景配置相应地址
应用场景1 代理商接入开发,服务商往该接口传送打印机状态实时消息,代理商需要对不同的消息进行处理,完整地址由客户自定义。
应用场景2 代理商不接入开发,在服务商系统平台查看最新打印机任务及状态,配置服务商提供的回调地址:https://tprint.colorpark.cn/api/OpenCallBack/printerCallBack
应用场景3 值为空,不推送回调,不更新任何平台设备数据。

回调结果

| 参数名|数据类型 | 参数值(示例) |参数说明| | --- | --- |----| | printer_id |string| 500001 | 分配打印的打印机编号 | | once |string| 8305 | 每次请求发送的随机数值 | | time |string| 1646790335 | 每次发送请求时的时间戳 | | sign |string| 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | 签名 | | status |string| 1 | 打印机状态,与打印任务回调同步推送   0: 离线 1:空闲 2:打印中 3:故障 4:维护| | msg|string | 空闲 | 打印机状态描述| | fault_status |string| 1 | 故障状态:1-进料失败 2-出货失败 3-归位失败 4-打印机复位失败 5-系统错误 6-打印错误 7-下降失败 8-未知错误| | fault_status_msg|string | 进料失败|故障描述| | stock_status|string | 1 | 库存状态:1-库存充足 2-库存不足| | stock_status_msg |string| 库存不足 |库存描述| | ink_status |string| 1 | 墨量状态:1-墨量充足2-墨量不足| | ink_status_msg |string| 墨量充足| 墨量描述| | error_status |string| 1 | 错误状态:1-网络错误 2-打印错误 3-系统错误 4-未知错误| | error_status_msg |string| 网络错误 | 错误状态描述| | other_status |string| -1 | 其他状态:1-机器正在清洗中 2-机器清洗完成 3-机器取消清洗 | | other_status_msg |string| 机器正在清洗中 | 其他状态描述| | phone |string| 19900990000 | 设备维护手机号| | notice_time|string | 2022-07-19 17:08:30 | 通知时间 |


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

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