欢迎!这里是飞印API文档

飞印API文档描述、示例


查询打印任务状态

<p><strong>简要描述:</strong> </p> <ul> <li>您的网站/业务系统可以通过查询打印任务功能查询已发出的打印任务状态,例如“队列中”,“已打印”等。</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://my.feyin.net/api/queryState</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>查询打印任务状态的请求以及参数须采用HTTP GET发送。 </li> </ul> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">规约</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">reqTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">请求(发生)时间戳,数值型</td> <td>本次API请求发生的时刻,值为自 1970-1-1 0:0 到现在的 毫秒数 类似于Java语言中的 System.currentTimeMillis() 函数的取值。</td> </tr> <tr> <td style="text-align: left;">securityCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">安全校验码,字符串</td> <td>调用飞印API的网站/应用系统用 API_KEY 针对请求内容生成的MD5哈希字串,此字串将被飞印API用于请求有效性的验证。 请参考 使用前的准备 了解如何获取 API_KEY 。</td> </tr> <tr> <td style="text-align: left;">memberCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">商户编码,数值型</td> <td>您在 飞印中心 注册的帐号对应的(系统自动生成的)商户编码,可登录飞印中心按指引获取。</td> </tr> <tr> <td style="text-align: left;">msgNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">信息/订单编号,字符串</td> <td>自定义的打印信息编号,可选,一般由调用网站/应用系统自动生成,用于跟踪订单。如果没有设置,飞印API将给每个打印请求自动分配一个。</td> </tr> </tbody> </table> <p><strong>返回状态码说明</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">0</td> <td>打印请求/任务中队列中,等待打印</td> </tr> <tr> <td style="text-align: left;">1</td> <td>打印任务已完成/请求数据已打印</td> </tr> <tr> <td style="text-align: left;">2</td> <td>打印任务/请求失败</td> </tr> <tr> <td style="text-align: left;">9</td> <td>打印任务/请求已发送</td> </tr> <tr> <td style="text-align: left;">-1</td> <td>IP地址不允许</td> </tr> <tr> <td style="text-align: left;">-2</td> <td>关键参数为空或请求方式不对</td> </tr> <tr> <td style="text-align: left;">-3</td> <td>客户编码不正确</td> </tr> <tr> <td style="text-align: left;">-4</td> <td>安全校验码不正确</td> </tr> <tr> <td style="text-align: left;">-5</td> <td>请求时间失效。请求时间和请求到达飞印API的时间长超出安全范围。请参考 同步应用服务器时间 了解更多飞印API的时间安全设置。</td> </tr> <tr> <td style="text-align: left;">-6</td> <td>订单编号错误或者不存在</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多例子请看飞印官网的实例代码描述</li> </ul>

页面列表

ITEM_HTML