查询打印异常
<p><strong>简要描述:</strong> </p>
<ul>
<li>
<p>无线移动网络或停电的外部因素可以导致飞印无线打印机打印失败。每当这类事故发生时,飞印API将对失败的打印请求生成异常日志。用户可以用查询打印异常的API功能来查询相关异常信息,方便诊断问题和解决问题。</p>
</li>
<li>每当收到查询打印异常的请求时,飞印API将根据用户指定的时间段(默认是最后10天)内、用户所拥有的所有飞印打印机的打印异常,并返回XML格式的异常日志信息。</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://my.feyin.net/api/listException</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>查询打印异常的请求及其参数须采用HTTP GET发送给飞印API。 </li>
</ul>
<p><strong>参数:</strong> </p>
<p>用于查询打印异常的请求须包含以下参数(粗体部分为必填):</p>
<p><strong>reqTime</strong> :请求(发生)时间戳,数值型
本次API请求发生的时刻,值为自 1970-1-1 0:0 到现在的 毫秒数 类似于Java语言中的 <code>System.currentTimeMillis()</code> 函数的取值。</p>
<p><strong>securityCode</strong> :安全校验码,字符串
调用飞印API的网站/应用系统用 API_KEY 针对请求内容生成的MD5哈希字串,此字串将被飞印API用于请求有效性的验证。 请参考 使用前的准备 了解如何获取 API_KEY 。</p>
<p><strong>memberCode</strong> :商户编码,数值型
您在 飞印中心 注册的帐号对应的(系统自动生成的)商户编码,可登录飞印中心按指引获取。</p>
<p>start :查询的开始日期,日期字符串
用 yyyy-MM-dd 格式。例如: 2010-09-03 是指 2010年9月3日 。如此参数留空,默认为最近10天。</p>
<p>end :查询的截至日期,日期字符串
用 yyyy-MM-dd 格式。例如: 2010-09-03` 是指 2010年9月3日 。如此参数留空,默认为今天。</p>
<hr />
<p><strong>返回示例</strong></p>
<p>XML字符串 :查询打印异常日期的请求返回XML格式的信息,例如:</p>
<pre><code>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;exceptionList begin=&quot;2010-10-08&quot; end=&quot;2010-10-18&quot;&gt;
&lt;exception&gt;
&lt;msgNo&gt;12873947857&lt;/msgNo&gt;
&lt;msgTime&gt;2010-10-18 17:39&lt;/msgTime&gt;
&lt;customer&gt;&lt;![CDATA[ Name: Ms Liu,Phone: 13321332245, Add: SCUT
North Campus, Notes: Please hurry up. ]]&gt; &lt;/customer&gt;
&lt;detail&gt;
&lt;![CDATA[
Fried noodle-1000-1 Fried chicken legs-2000-1
]]&gt;
&lt;/detail&gt;
&lt;/exception&gt;
&lt;exception&gt;
&lt;msgNo&gt;12873945227&lt;/msgNo&gt;
&lt;msgTime&gt;2010-10-18 17:35&lt;/msgTime&gt;
&lt;customer&gt;&lt;![CDATA[ ]]&gt; &lt;/customer&gt;
&lt;detail&gt;&lt;![CDATA[
This is free-form print data. Please limit your text within 4KB in size
in each print request you send.]]&gt;
&lt;/detail&gt;
&lt;/exception&gt;
&lt;/exceptionList&gt;</code></pre>
<p>begin 和 end 用来指定查询打印异常发生的时间段。它们都是日期字符串,格式为 YYYY-MM-DD 。</p>
<p>msgNo 是用户(API调用网站/系统)自行指定的打印请求编号。</p>
<p>msgTime 是指请求发生的时间。</p>
<p>customer 是指客户信息(只用于格式化打印请求)。</p>
<p>detail 是打印请求的数据/内容。</p>
<p><strong>返回参数说明</strong> </p>
<p>查询打印异常信息功能可返回以下状态码:</p>
<p>-1 :IP地址不允许</p>
<p>-2 :关键参数为空或请求方式不对</p>
<p>-3 :客户编码不正确</p>
<p>-4 :安全校验码不正确</p>
<p>-5 :请求时间失效。请求时间和请求到达飞印API的时间长超出安全范围。请参考 同步应用服务器时间 了解更多飞印API的时间安全设置。</p>
<p><strong>备注</strong> </p>
<ul>
<li>更多例子请看飞印官网的实例代码描述</li>
<li>测试查询打印异常</li>
</ul>
<p>您可通过 testListException() 这个方法测试查询打印异常功能。请参考 飞印API集成示例代码 中的示例代码了解具体的使用。</p>