查询打印异常

简要描述：

• 无线移动网络或停电的外部因素可以导致飞印无线打印机打印失败。每当这类事故发生时，飞印API将对失败的打印请求生成异常日志。用户可以用查询打印异常的API功能来查询相关异常信息，方便诊断问题和解决问题。

• 每当收到查询打印异常的请求时，飞印API将根据用户指定的时间段（默认是最后10天）内、用户所拥有的所有飞印打印机的打印异常，并返回XML格式的异常日志信息。

请求URL：

• http://my.feyin.net/api/listException

请求方式：

• 查询打印异常的请求及其参数须采用HTTP GET发送给飞印API。

参数：

用于查询打印异常的请求须包含以下参数（粗体部分为必填）：

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

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

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

start ：查询的开始日期，日期字符串 用 yyyy-MM-dd 格式。例如： 2010-09-03 是指 2010年9月3日 。如此参数留空，默认为最近10天。

end ：查询的截至日期，日期字符串 用 yyyy-MM-dd 格式。例如： 2010-09-03` 是指 2010年9月3日 。如此参数留空，默认为今天。

---

返回示例

XML字符串 ：查询打印异常日期的请求返回XML格式的信息，例如:

<?xml version="1.0" encoding="UTF-8"?>
<exceptionList begin="2010-10-08" end="2010-10-18">
  <exception>
    <msgNo>12873947857</msgNo>
    <msgTime>2010-10-18 17:39</msgTime>
    <customer><![CDATA[  Name: Ms Liu,Phone: 13321332245, Add: SCUT
            North Campus, Notes: Please hurry up. ]]> </customer>
    <detail>
    <![CDATA[
    Fried noodle-1000-1 Fried chicken legs-2000-1
    ]]>
    </detail>
  </exception>

  <exception>
    <msgNo>12873945227</msgNo>
    <msgTime>2010-10-18 17:35</msgTime>
    <customer><![CDATA[  ]]> </customer>
    <detail><![CDATA[
    This is free-form print data. Please limit your text within 4KB in size
    in each print request you send.]]>
    </detail>
  </exception>
</exceptionList>

begin 和 end 用来指定查询打印异常发生的时间段。它们都是日期字符串，格式为 YYYY-MM-DD 。

msgNo 是用户（API调用网站/系统）自行指定的打印请求编号。

msgTime 是指请求发生的时间。

customer 是指客户信息（只用于格式化打印请求）。

detail 是打印请求的数据/内容。

返回参数说明

查询打印异常信息功能可返回以下状态码：

-1 ：IP地址不允许

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

-3 ：客户编码不正确

-4 ：安全校验码不正确

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

备注

• 更多例子请看飞印官网的实例代码描述
• 测试查询打印异常

您可通过 testListException() 这个方法测试查询打印异常功能。请参考 飞印API集成示例代码 中的示例代码了解具体的使用。