欢迎!这里是飞印API文档

飞印API文档描述、示例


查询消息打印状态

<p><strong>简要描述:</strong> </p> <ul> <li>可以通过本接口查询已发出的打印消息的当前打印状态,例如“等待打印中”,“已打印”,“已取消”等。</li> <li>只允许查询7天以内的订单状态,如果需要更长时间范围的订单,请联系客服</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>https://api.open.feyin.net/msg/{msg_no}/status?access_token=ACCESS_TOKEN</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>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">msg_no</td> <td style="text-align: left;">是</td> <td>每个打印消息均有个唯一的id,该值为调用“<a href="https://www.showdoc.cc/1687352?page_id=82826059039914" title="发送打印消息">发送打印消息</a>” API时,指定/返回的msg_no</td> </tr> </tbody> </table> <p><strong>返回说明</strong></p> <p>正常情况下,飞印开放平台会返回下述JSON数据:</p> <p><strong>消息已打印时</strong></p> <pre><code class="language-json"> { "msg_no":"ORDER-201712201500", "status":"finished", "msg_time":"2018-01-01:10:00:00", "print_time":"2018-01-01:10:00:05" }</code></pre> <p><strong>消息还未打印时</strong></p> <pre><code class="language-json"> { "msg_no":"ORDER-201712201500", "status":"pending", "msg_time":"2018-01-01:10:00:00", "print_time":"" }</code></pre> <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 style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">msg_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td style="text-align: left;">本次打印消息的唯一标记, 跟请求本api时指定的msg_no一致</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td style="text-align: left;">打印状态,<br> <strong>pending</strong> 表示等待打印中,<br> <strong>finished</strong> 表示已打印完成 <br> <strong>cancel</strong> 表示订单已被取消或超时未打印</td> </tr> <tr> <td style="text-align: left;">msg_time</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td style="text-align: left;">为飞印平台接收到这个消息的时间</td> </tr> <tr> <td style="text-align: left;">print_time</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td style="text-align: left;">消息打印的时间,如果该消息还未打印,则为空字符串</td> </tr> </tbody> </table> <p>错误时飞印开放平台会返回错误码等信息,JSON数据详见“<a href="https://www.showdoc.cc/1687352?page_id=137418124005771" title="全局返回码说明">全局返回码说明</a>”</p>

页面列表

ITEM_HTML