第三方平台通过调用查询打印机状态接口（/api/printer/getPrinterStatus），向开放平台发送指令查询当前打印机的实时运行状态，平台处理后将同步返回打印机状态、状态描述及通知时间，用于实时监控设备在线与工作状态。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | https://www.colorpark.cn/api/printer/getPrinterStatus |
| 请求方式 | POST |
请求参数
| 参数名 | 参数值（示例） | 数据类型 | 必填项 | 参数说明 |
|---|---|---|---|---|
| printer_id | 500001 | string | 是 | 打印机分配的唯一 ID 号，每一台打印都会分配一个不同的编号 |
| once | 8305 | string | 是 | 加密生成签名时使用的随机数值 |
| time | 1646790335 | string | 是 | 加密生成签名时使用的时间戳 |
| sign | 9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | 是 | 生成的签名，生成方式请参考《底层方法【基础支撑】》生成签名章节 |
返回结果
| 字段 | 数据类型 | 参数值（示例） | 参数说明 |
|---|---|---|---|
| code | string | 0 | 返回结果状态码，成功时为 0，失败时为 1 |
| msg | string | Success | 返回结果描述，如：Success |
| data.msg | string | 离线 | 打印状态状态，离线 |
| data.status | string | 0 | 打印任务状态，0-离线 1-空闲 2-打印中 3-故障 4-维护 |
| data.notice_time | string | 2025-11-28 14:42:28 | 通知时间 |
注：
data.msg字段说明原文写作「打印状态状态」，与「打印机状态」语境稍有不符，如实保留。
若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下： 电 话：137-5177-4454【微信同号】 邮 箱：info@ColorPark.cn