查询打印机状态

飞印API支持查询已部署飞印移动打印机（终端）的实时工作状态。当飞印API收到一个查询打印机设备状态的请求时，将检查一遍调用方所拥有的所有飞印移动打印机，并返回一段状态信息和对应的状态码。

API端点

http://my.feyin.net/api/listDevice

API调用方法

飞印API打印请求及其参数应该用HTTP GET方式发送。

必填参数

查询打印（终端）状态的API功能应该包含以下必填参数（粗体部分）：

reqTime ：请求（发生）时间戳，数值型

本次API请求发生的时刻，值为自 1970-1-1 0:0 到现在的 毫秒数 类似于Java语言中的 System.currentTimeMillis() 函数的取值。

securityCode ：安全校验码，字符串

调用飞印API的网站/应用系统用 API_KEY 针对请求内容生成的MD5哈希字串，此字串将被飞印API用于请求有效性的验证。 请参考 使用前的准备 了解如何获取 API_KEY 。

memberCode ：商户编码，数值型

您在 飞印中心 注册的帐号对应的（系统自动生成的）商户编码，可登录飞印中心按指引获取。

返回信息

XML字符串 ：正常的打印状态查询返回信息采用XML格式，例如:

<?xml version="1.0" encoding="UTF-8"?>
<deviceList>
    <device id="4600000006463940">
    <address>Device Installation Address </address>
    <since>2010-09-20</since>
    <simCode>13560081341</simCode>
    <lastConnected>2010-09-26  18:09:29</lastConnected>
    <deviceStatus>Normal</deviceStatus>
    <paperStatus>Normal</paperStatus>
    </device>
</deviceList>

since 是指打印机的激活日期。

simCode 是指打印机对应的IMSI编码（打印机本身采用的移动SIM卡唯一识别号）。

lastConnected 是指打印机最后一次通信连接发生的时刻。

deviceStatus 是指打印机的连接状态，包括： 离线 ， 在线 。

paperStatus 是指打印纸张的状态，包括 正常 或 缺纸 。

返回的状态码

飞印API对查询打印机（终端）状态的请求返回以下状态码：

-1 ：IP地址不允许

-2 ：关键参数为空或请求方式不对

-3 ：客户编码不正确

-4 ：安全校验码不正确

-5 ：请求时间失效。请求时间和请求到达飞印API的时间长超出安全范围。请参考 同步应用服务器时间 了解更多飞印API的时间安全设置。

测试查询打印机状态

您可以用 testListDevice() 这个方法测试查询打印机状态。请参考 飞印API集成示例代码 了解更详细的使用。