# 自有应用服务模式 本开发攻略介绍自有服务模式下获取Access Token的授权验证 ,终端授权 每个Client Id 的 Access Token获取或刷新频次限制共: 20次/日 该模式下Access 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":"非法参数"} ~~~