查询打印任务状态
您的网站/业务系统可以通过查询打印任务功能查询已发出的打印任务状态,例如“队列中”,“已打印”等。
API功能端点
http://my.feyin.net/api/queryState
API调用方法
查询打印任务状态的请求以及参数须采用HTTP GET发送。
必填参数
查询打印任务状态的API功能应该包含以下必填参数(粗体部分):
reqTime :请求(发生)时间戳,数值型
本次API请求发生的时刻,值为自 1970-1-1 0:0 到现在的 毫秒数 类似于Java语言中的 System.currentTimeMillis() 函数的取值。
securityCode :安全校验码,字符串
调用飞印API的网站/应用系统用 API_KEY 针对请求内容生成的MD5哈希字串,此字串将被飞印API用于请求有效性的验证。 请参考 使用前的准备 了解如何获取 API_KEY 。
memberCode :商户编码,数值型
您在 飞印中心 注册的帐号对应的(系统自动生成的)商户编码,可登录飞印中心按指引获取。
msgNo :信息/订单编号,字符串
自定义的打印信息编号,可选,一般由调用网站/应用系统自动生成,用于跟踪订单。如果没有设置,飞印API将给每个打印请求自动分配一个。
返回状态码
查询打印任务请求返回以下状态码:
0 :打印请求/任务中队列中,等待打印
1 :打印任务已完成/请求数据已打印
2 :打印任务/请求失败
9 :打印任务/请求已发送
-1 :IP地址不允许
-2 :关键参数为空或请求方式不对
-3 :客户编码不正确
-4 :安全校验码不正确
-5 :请求时间失效。请求时间和请求到达飞印API的时间长超出安全范围。请参考 同步应用服务器时间 了解更多飞印API的时间安全设置。
-6 :订单编号错误或者不存在
测试查询打印任务
飞印提供一个测试方法 testQueryState() ,供测试查询打印任务状态功能。请通过参考 飞印API集成示例代码 了解更详细的用法示例。