查询消息打印状态
<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>