### 極速授權 僅支持開放型應用服務
為了方便用戶在手機,平板等移動設備上快速完成授權,提升用戶體驗,易聯云推出了極速授權接口,開發者可以方便的使用終端號和特殊密鑰快速完成授權
步驟(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使用說明
- 注意事項
- 全局返回碼
- 獲取終端號和特殊密鑰