# 自有應用服務模式
本開發攻略介紹自有服務模式下獲取Access Token的授權驗證 ,終端授權
每個Client Id 的 Access Token獲取或刷新頻次限制共: 20次/日
該模式下Access Token 無失效時間,做好存儲避免多次獲取導致頻次超過限制!!!
終端授權接口不需要重復獲取Access Token!Token與應用綁定,而非與設備綁定,該模式下的Token所有設備共用!!
[TOC=3,4]
### 獲取Access Token
地址:`https://open-api.10ss.net/oauth/oauth`
[境外地址](apiprotocol.md)
請求方式:POST
請求參數說明:
|名 稱|類 型|描 述|
|----|----|----|
|client_id|string|易聯云頒發給開發者的應用ID 非空值|
|grant_type|string|授與方式(固定為'client_credentials')|
|sign|string|簽名 詳見API文檔列表-[接口簽名](apiprotocol.md)|
|scope|string|授權權限,傳all|
|timestamp|int|當前服務器時間戳(10位)|
|id|string|UUID4 詳見API文檔列表-[uuid4](apiprotocol.md)|
### 使用Refresh token更新Access Token
地址:`https://open-api.10ss.net/oauth/oauth`
請求方式:POST
所需參數
每個Client Id 的 Access Token更新頻次限制: 20次/日
|名 稱|類 型|描 述|
|----|----|----|
|client_id|string|易聯云頒發給開發者的應用ID 非空值|
|grant_type|string|授與方式(固定為 “refresh_token”)|
|scope|string|授權權限,傳all|
|sign|string|簽名 詳見API文檔列表-[接口簽名](apiprotocol.md)|
|refresh_token|string|更新access_token所需|
|id|string|UUID4 詳見API文檔列表-[uuid4](apiprotocol.md)|
|timestamp|int|當前服務器時間戳(10位)|
### 同步響應參數說明
多臺打印機共用一個access_token,請開發者做好保存
|名 稱|類 型|描 述|
|----|----|----|
|access_token|string|訪問令牌,API調用時需要,令牌可以重復使用無失效時間,請開發者全局保存|
|refresh_token|string|更新access_token所需,有效時間35天|
|expires_in|int|令牌的有效時間,單位秒 (30天),注:該模式下可忽略此參數|
|machine_code|string|易聯云終端號|
示例如下:
~~~
{'error':'0','error_description':'success','body':{'access_token':'xxxx','refresh_token':'xxxx','expires_in':2592000,'scope':'all'}}
{'error':'11', 'error_description':'sign驗證失敗'},
{'error':'12', 'error_description':'缺少必要參數'},
{'error':'15','error_description':'權限不能大于初次授權的權限'}
{'error':'19', 'error_description':'應用未上架或已下架'},
{'error':'41', '獲取或更新access_token的次數,已超過最大限制次數!'},
~~~
### 終端授權 (永久授權)
使用此接口,開發者將獲得此臺打印機的接口權限
請求地址:`https://open-api.10ss.net/printer/addprinter`
請求方式:POST
|名 稱|類 型|描 述|
|----|----|----|
|client_id|string|易聯云頒發給開發者的應用ID 非空值|
|machine_code|string|易聯云打印機終端號|
|msign|string|易聯云終端密鑰|
|access_token|string|授權的token 必要參數|
|sign|string|簽名 詳見API文檔列表-[接口簽名](apiprotocol.md)|
|id|string|UUID4 詳見API文檔列表-[uuid4](apiprotocol.md)|
|timestamp|int|當前服務器時間戳(10位)|
|phone|string|手機卡號碼(可填)|
|print_name|string|自定義打印機名稱(可填)|
示例如下:
~~~
{"error":"0","error_description":"success"}
{"error":"2","error_description":"client_id不存在"}
{"error":"11","error_description":"sign驗證失敗"}
{"error":"12","error_description":"缺少必要參數"}
{"error":"16","error_description":"不支持k1,k2,k3機型"}
{'error':'18', 'error_description':'access_token過期或錯誤,請刷新access_token或者重新授權'},
{'error':'33', 'error_description':'Uuid不合法'}
{"error":"34","error_description":"非法參數"}
~~~
- 平臺簡介
- 概念和術語
- 新手指南
- 開發文檔
- 接入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使用說明
- 注意事項
- 全局返回碼
- 獲取終端號和特殊密鑰