基础说明
协议定义
三方厂商对接服务
登录授权
打印机绑定
打印机解绑
文本打印任务推送
文件打印任务推送
语音播报任务推送-云喇叭
设备信息获取
待打印任务队列获取
待打印任务队列清空
设备状态/任务结果回调
其它
附录A--设备状态
附录B--秘钥规定
附录C--定制语音描述
打印机排版约定
服务器对接示例代码
协议定义
1.说明
本文档定义标准的云打印接口,为三方应用提供统一、安全的云打印机管理及票据打印服务。
云打印机包括热敏打印机(含58mm、80mm、110mm宽度的标签及票据)、针式打印机、激光及喷墨打印机,打印云盒。
一次对接,多机型通用。
注意:文档标明必填的关键参数,访问前请加以验证,否则服务器IP会被拉入防火墙黑名单,
次月
自动解除。
2.操作流程
登录官网(https://www.sw-aiot.com/),填写公司信息,注册用户账号(或通过代理商获取操作账号)。
登陆用户中心,完善账号详细信息。
阅读官方文档,根据接口《登录授权》,获取该账户对应的token,用作其他接口访问的权鉴秘钥。
注:token参数需要放在API请求的header参数中,以其他形式传输,会被拦截器拦截,部分接口访问会被拒绝。
根据设备底部机器码和验证码,通过《打印机绑定》接口将设备绑定到该账号下。
注:设备必须提前绑定,然后才能通过该账号的token将任务推送到设备。不绑定则无法推送。
三方系统推送打印任务前,需将打印内容参考《打印机排版约定》按照固定格式编排好,再通过《文本打印任务推送》接口发送至厂商服务器。
语音播报请根据接口参数约定,推送任务到厂商云服务器,设备即可播报。
3.API接口参数格式及方法
请求方式:POST
数据格式:application/json
4.API接口返回参数
API应答结果为JSON数据格式。详细请参考《三方厂商对接服务》描述章节。
5.POSTMAN操作示例
操作示例下载