第三方需在开放平台配置自定义回调地址，当打印机状态发生更新时，开放平台会以 POST 方式实时推送打印机状态信息至该地址，便于第三方实时监控设备运行状态并进行后续处理（如告警、调度、统计）。
回调地址
打印机状态回调：2025-11-19 之前的商户使用 v1 版本。
| 项目 | 值 |
|---|---|
| 接口地址示例 | 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 | 完成打印 | 根据打印机状态显示不同信息。0：离线 1：空闲 2：打印中 3：故障 4：维护 |
| notice_time | string | 2022-07-19 17:08:30 | 通知时间 |
注：
msg字段示例值写作「完成打印」，与打印机状态语境不符，疑为笔误，如实保留。
若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下： 电 话：137-5177-4454【微信同号】 邮 箱：info@ColorPark.cn