查询消息打印状态
简要描述:
- 可以通过本接口查询已发出的打印消息的当前打印状态,例如“等待打印中”,“已打印”,“已取消”等。
- 只允许查询7天以内的订单状态,如果需要更长时间范围的订单,请联系客服
请求URL:
https://api.open.feyin.net/msg/{msg_no}/status?access_token=ACCESS_TOKEN
请求方式:
- 查询打印任务状态的请求以及参数须采用HTTP GET发送。
参数:
参数名 | 必选 | 说明 |
---|---|---|
msg_no | 是 | 每个打印消息均有个唯一的id,该值为调用“[发送打印消息](https://www.showdoc.cc/1687352?page_id=82826059039914 "发送打印消息")” API时,指定/返回的msg_no |
返回说明
正常情况下,飞印开放平台会返回下述JSON数据:
消息已打印时
{
"msg_no":"ORDER-201712201500",
"status":"finished",
"msg_time":"2018-01-01:10:00:00",
"print_time":"2018-01-01:10:00:05"
}
消息还未打印时
{
"msg_no":"ORDER-201712201500",
"status":"pending",
"msg_time":"2018-01-01:10:00:00",
"print_time":""
}
返回参数说明
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
msg_no | 是 | string | 本次打印消息的唯一标记, 跟请求本api时指定的msg_no一致 |
status | 是 | string | 打印状态,<br> pending 表示等待打印中,<br> finished 表示已打印完成 <br> cancel 表示订单已被取消或超时未打印 |
msg_time | 是 | string | 为飞印平台接收到这个消息的时间 |
print_time | 否 | string | 消息打印的时间,如果该消息还未打印,则为空字符串 |
错误时飞印开放平台会返回错误码等信息,JSON数据详见“[全局返回码说明](https://www.showdoc.cc/1687352?page_id=137418124005771 "全局返回码说明")”