
文章主要介绍小票打印机如何对接API接口,升级后目前支持多种后台语言,API接口支持PHP、Java、C#、Python、NodeJS等语言,用户可以根据自己的需求下载相对应的文档。
进入网站开放平台打开网址注册账户信息,可注册为个人或企业开发者,注册成功后,即可获得AppKey和AppSecret,①注册②填写账号信息③同意协议点击下一步。
根据系统提示填写相应的企业信息,并上传资质,在顶端我们可以看到这样的温馨提示:通过【企业开发者】认证的企业开发者较个人开发者可获得优先的技术支持。
备注:如果【企业开发者】暂时资料准备不齐全无法完成企业认证,可点击此处跳过认证直接注册。
【邮箱验证】前往邮箱打开邮件点击链接完成验证,也可以跳过邮箱验证直接注册,邮箱验证的好处是:如果后期忘记账号或者密码,可以通过绑定的邮箱找回。
注册完成后,系统会自动跳转到登陆页面,输入账号密码进入后台管理,然后我们就可以看到AppKey和AppSecret。
接口请求和响应统一使用json格式数据传输,统一为Http Post请求方式。
请求参数说明:在发起请求的时候,需要在url后面拼接一下几个参数,如下图所示。
Signature生成方法为:appsecret(平台账户后台可获得),timestamp,nonce三个参数的值进行字典(正序)排序后拼接在一起,进行sha1加密得到的字符串。
用户设备绑定:
打开请求地址,请求参数,参数设置,具体说明,设备编码双击打印机设备D1按键即可获取。
查询设备状态:
状态值(-1错误 0正常 1缺纸 2温度保护报警 3忙碌 4离线)
提交打印任务:
PrintType:(0文本1图片3条码4二维码)
Alignment:(0居左1居中2居右)
Bold:(0不加粗1加粗)
FontSize:(0默认大小1大一号)
BaseText:文本(gbk编码)base64字符串或图片的base64字符串
查询打印任务状态:
状态码说明
200 成功
1000 服务处理异常
1001 验证签名错误
1002 链接失效
1003 参数错误
1004 AppId不存在
1005 设备不存在
1006 开发者账号已被禁用
1007 任务不存在或权限不足
1008 未通过认证
1009 限制调用
1010 设备未连接
1011 与服务器断开链接
1012 打印任务不能为空
