查询打印机状态
- 开发者可以通过如下几个api来获取当前打印机的运行状态
- 我们更推荐使用预定的[[回调接口]][callback_api]来获取打印机的实时运行状态
获取打印机状态分为如下几个api 1. 查看指定打印机状态 2. 查看所有打印机状态
<h4 id="1">查看指定打印机状态</h4>
- 通过本api查询打印机(终端)的实时工作状态,譬如在线、离线、缺纸等等打印机工作状态。
请求URL:
https://api.open.feyin.net/device/{device_no}/status?access_token=ACCESS_TOKEN
请求参数:
参数名 | 类型 | 说明 |
---|---|---|
device_no | string | 设备编码 |
请求方式:
- GET
返回示例
{
"device_no": "5a58867e0aca3027f742a4de",
"since": "2010-09-20",
"status": "online",
"paper_status": "normal",
"last_connected_at": "2018-01-18 17:57:18"
}
返回参数说明
返回数据类型: JSON数组
参数名 | 类型 | 说明 |
---|---|---|
device_no | string | 设备编码 |
since | string | 打印机激活时间 |
status | string | 打印机的连接状态,包括:<br> online 在线 <br> offline 离线 <br> overheat 打印头过热 <br> error 打印机系统故障 |
paper_status | string | 打印纸张的状态,包括:<br> nomal 正常 <br> lack 缺纸 |
last_connected_at | string | 最近连接时间 |
<h4 id="2">查看所有打印机状态:</h4>
- 通过本api查询打印机(终端)的实时工作状态,譬如在线、离线、缺纸等等打印机工作状态。
请求URL:
https://api.open.feyin.net/devices?access_token=ACCESS_TOKEN
请求方式:
-
GET
返回示例
[
{
"device_no": "5a58867e0aca3027f742a4de",
"since": "2010-09-20",
"status": "online",
"paper_status": "normal",
"last_connected_at": "2018-01-18 17:57:18"
},
{
"device_no": "938c8867e8fed3027f741992b",
"since": "2010-09-21",
"status": "offline",
"paper_status": "lack",
"last_connected_at": "2018-01-18 15:57:18"
}
]
返回参数说明
返回数据类型: JSON数组
参数名 | 类型 | 说明 |
---|---|---|
device_no | string | 设备编码 |
since | string | 打印机激活时间 |
device_status | string | 打印机的连接状态,包括:<br> online 在线 <br> offline 离线 <br> overheat 打印头过热 <br> error 打印机系统故障 |
paper_status | string | 打印纸张的状态,包括:<br> nomal 正常 <br> lack 缺纸 |
last_connected_at | string | 最近连接时间 |
[callback_api]: https://www.showdoc.cc/web/#/feyin?page_id=137487644951698 "回调接口"