欢迎!这里是飞印API文档

飞印API文档描述、示例


查询消息打印状态

简要描述:

  • 可以通过本接口查询已发出的打印消息的当前打印状态,例如“等待打印中”,“已打印”,“已取消”等。
  • 只允许查询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 "全局返回码说明")”

页面列表

ITEM_HTML