### 极速授权 仅支持开放型应用服务
为了方便用户在手机,平板等移动设备上快速完成授权,提升用户体验,易联云推出了极速授权接口,开发者可以方便的使用终端号和特殊密钥快速完成授权
步骤(1): 开发者的应用获得易联云的machine_code和qr_key或msign; ([如何快速获取终端号和特殊密钥或设备密钥](machine_code.md))
步骤(2): 根据下面接口发送数据到易联云oauth2.0平台获取access_token;
地址:`https://open-api.10ss.net/oauth/scancodemodel`
请求方式:POST
所需参数
|名 称|类 型|描 述|
|----|----|----|
|client_id|string|易联云颁发给开发者的应用ID 非空值|
|machine_code|string|易联云打印机终端号|
|qr_key|string|特殊密钥(有效期为300秒)与`maign`二选一,请勿同时传入|
|msign|string|终端密钥与`qr_key`二选一,请勿同时传入|
|scope|string|授权权限,传all|
|sign|string|签名 详见API文档列表-[接口签名](apiprotocol.md)|
|id|string|UUID4 详见API文档列表-[uuid4](apiprotocol.md)|
|timestamp|int|当前服务器时间戳(10位)|
示例如下:
~~~
{"error":"0","error_description":"success","body":{"access_token":"xxxx","refresh_token":"xxxx","expires_in":2592000,"scope":"all"}}
{"error":"2","error_description":"client_id不存在"}
{"error":"11","error_description":"sign验证失败"}
{"error":"27","error_description":"请设置scope,权限默认为all"}
{"error":"29","error_description":"client_id,machine_code,qr_key不能为空"}
{"error":"30","error_description":"machine_code,qr_key错误"}
{"error":"31","error_description":"接口不支持自有应用服务模式"}
~~~
### 同步响应参数说明
|名 称|类 型|描 述|
|----|----|----|
|access_token|string|访问令牌,API调用时需要,在令牌有效期内可以重复使用,请开发者全局保存|
|refresh_token|string|更新access_token所需,有效时间35天|
|expires_in|string|令牌的有效时间,单位秒 (30天)|
- 平台简介
- 概念和术语
- 新手指南
- 开发文档
- 接入API服务指南
- API调用协议说明
- 开放应用服务模式
- 自有应用服务模式
- 扫描二维码授权模式
- 消息推送协议说明
- API文档列表
- 文本打印接口
- 图形打印接口
- 面单打印接口
- 设置内置语音接口
- 删除内置语音接口
- 删除终端授权
- 添加应用菜单
- 关机重启接口
- 声音调节接口
- 获取机型打印宽度接口
- 获取机型软硬件版本接口
- 取消所有未打印订单接口
- 取消单条未打印订单接口
- 设置logo接口
- 取消logo接口
- 打印方式接口
- 接单拒单设置接口
- 设置推送url接口
- 获取订单状态接口
- 获取订单列表接口
- 获取终端状态接口
- 推送接口
- 签名规则
- 打印完成推送
- 接单拒单推送
- 按键请求推送
- 应用菜单推送
- 打印机实时状态推送
- 打印机指令
- K7-GHC/K7-WHC排版指令
- K4-GH(新固件)/K4-WH(新固件)排版指令
- K6-WH(新固件)排版指令
- M1-G(新固件)排版指令
- W1(新固件)排版指令
- K5(新固件)排版指令
- K2S、K3S、M1排版指令
- K7、K6、K5、K4排版指令
- X1排版指令
- W1排版指令
- Ai语音播报指令
- 指令详解
- 二维码打印
- 条码打印
- 打印多联
- 字体加大
- 字体加粗
- 字体加高
- 字体加宽
- 换行
- 居中对齐
- 左右对齐
- 右对齐
- 一行三格或四格对齐排版
- 制表符
- 自定义来单提醒
- 自定义来单声音控制
- 订单确认
- SDK使用说明
- 注意事项
- 全局返回码
- 获取终端号和特殊密钥