总体说明

开发者在佳博云平台「 https://cp.poscom.cn/ 」 注册账号并登录「已有账号的可以直接登录」,可以使用自主授权模式引导拥有打印机设备的商户对其授权,授权成功后,开发者拥有对终端商户设备的部分处理权限。

  • 查询客户名下所有打印机列表
  • 查询某一台打印机状态
  • 发送打印订单到打印机
  • 查询订单打印结果

授权流程

如何获取授权URL

开发者在电脑端使用浏览器登录佳博云平台https://cp.poscom.cn ,在「系统集成」–>「Api集成」中可以看到开发者唯一的授权链接和取消授权链,如图:


注意:授权url和取消授权url均可通过添加state参数,参数值会在回调URL作为state参数返回

如:http://cp.poscom.cn/frontmanage/openoauth/authorize?code=C9D50D3A57666B64106D662C0962E52E&state=gainscha

如何集成授权URL

1)   获取到授权URL并加带上业务参数后http://cp.poscom.cn/frontmanage/openoauth/authorize?code=C9D50D3A57666B64106D662C0962E52E&state=gainscha ,可以直接通过内嵌/弹窗的方式打开授权登陆页;

2)  商户登录成功后,确认授权;

3)  授权成功,关闭页面或回退。

如何设置回调URL

开发者在电脑端使用浏览器登录佳博云平台https://cp.poscom.cn ,在【系统集成】–>【Api集成】中可以设置开发者名称和回调URL,回调URL支持https和http。


回调参数如下:

  • type,类型(1-授权,2-取消授权)
  • token,令牌,一个开发者一个商户对应一个唯一的token,永久有效,建议持久化保存
  • state,透传的业务参数

授权接口说明

获取打印机列表

参数名 参数类型 参数说明
reqTime String 请求时间戳,13位时间戳,必填
token String 授权token,必填
sign String 请求签名,md5(reqTime+token+开发者api密钥),api密钥在【系统集成】–>【Api集成】获取,必填
  • 返回参数
参数名 参数类型 参数说明
code String 0代表成功,其他失败
msg String 成功或失败原因
data String json数组字符串
data>>id String 打印机设备编号
data>>name String 打印机名称
data>>status String 打印机状态
{"msg":"OK","data":[{"name":"测试584","id":"00861833041617434","status":"离线"},{"name":"ceshi5668","id":"00391282539417000","status":"离线"},{"name":"测试2270","id":"00391282551211162","status":"离线"}],"code":"0"}

查询打印机状态

参数名 参数类型 参数说明
reqTime String 请求时间戳,13位时间戳,必填
token String 授权token,必填
deviceCode String 打印机设备编号,必填
sign String 请求签名,md5(reqTime+token+deviceCode+开发者api密钥),api密钥在【系统集成】–>【Api集成】获取,必填
  • 返回参数
参数名 参数类型 参数说明
code String 0代表成功,其他失败
msg String 成功或失败原因
data String json对象字符串
data>>status String 打印机状态 0-离线、1-在线、2-缺纸/开盖、3-过热、4-暂停、5-打印中、9-其他异常
{"msg":"OK","data":{"status":"0"},"code":"0"}

发送打印工单数据

参数名 参数类型 参数说明
reqTime String 请求时间戳,13位时间戳,必填
token String 授权token,必填
deviceCode String 打印机设备编号 ,必填
ordersInfo String json数组字符串 ,必填
ordersInfo>>orderId String 打印订单号,必填
ordersInfo>>mode String 订单数据格式,2-自由格式,如<gpWord>、3-十六进制指令格式,如1B40,必填
ordersInfo>>content String 订单数据,必填
sign String 请求签名,md5(reqTime+token+deviceCode+开发者api密钥),api密钥在【系统集成】–>【Api集成】获取
[{"mode":"2","orderId":"12345678","content":"<gpWord Align=1 Bold=1 Wsize=2 Hsize=2 Reverse=0 Underline=0>佳博云打印</gpWord>
<gpBarCode Align=1 Type=7 Width=2 Height=80 Position=0>201811080001</gpBarCode>"},{"mode":"3","orderId":"87654321", "content":"1B401B61011D48001D68501D77021D6B49107B4259303132333435363738393031320A"}]
  • 返回参数
参数名 参数类型 参数说明
code String 0代表成功,其他失败
msg String 成功或失败原因
data String json数组字符串,为空代表全部成功
data>>orderId String 失败工单号
data>>remark String json数组字符串,失败原因
{"msg":"OK","data":[{"orderId":"2020060500333","remark":"{\"code\":-7, \"msg\":\"消息号(msgNo)重复\"}"}],"code":"0"}

查询订单单打印结果

参数名 参数类型 参数说明
reqTime String 请求时间戳,13位时间戳,必填
token String 授权token,必填
orderId String 订单号 ,必填
sign String 请求签名,md5(reqTime+token+orderId+开发者api密钥),api密钥在【系统集成】–>【Api集成】获取
  • 返回参数
参数名 参数类型 参数说明
code String 0代表成功,其他失败
msg String 成功或失败原因
data String json对象字符串
data>>status String 订单状态 1-打印成功、2-队列中、3-查询失败
data>>remark String 状态说明
{"msg":"OK","data":{"remark":"订单编号错误或不存在","status":"3"},"code":"0"} 
文档更新时间: 2020-06-17 18:36   作者:佳博云打印