# 自有應用服務模式 本開發攻略介紹自有服務模式下獲取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":"非法參數"} ~~~