# 自有型应用 ### 一、阅读前提 1. 本篇介绍自有型应用如何获取调用凭证（access_token）。 2. 自有型应用下的调用凭证（access_token）无失效时间，接口返回的调用凭证有效期（expires_in）对其无效，超出范围也可以正常使用。 3. 自有型应用每日获取次数为20次，避免超出范围、受限。建议数据存储或者缓存。 4. 自有型应用下的调用凭证（access_token）对当前开发者用户账号下的设备都有效（access_token与client_id绑定）。建议一个开发者用户账号下只有唯一的自有型应用，当然平台侧没限制创建。 5. 重新获取access_token后，旧的access_token将在两小时内失效。因此，请确保及时替换为最新获取的access_token。 6. 关于接口域名、签名等信息，请详读[调用协议](调用协议.md) ### 二、授权接口 #### 接口信息 |协议|方式|地址 |-|-|-| |https|POST|/oauth/oauth #### 请求参数 |名称|类型|必填|描述 |-|-|-|-|-| |client_id|string|是|应用id |grant_type|string|是|默认值`client_credentials` |sign|string|是|签名 |scope|string|是|权限范围，默认值`all` |timestamp|int|是|时间戳（秒） |id|string|是|请求唯一标识码 #### 响应参数 |名称|类型|描述 |-|-|-|-| |error|int|成功0，其他为异常 |error_description|string|提示信息 |timestamp|int|时间戳（秒） |body|json|数据 #### body 字段示例 ```json { "client_id": "10******24", "access_token": "0a***************a4", "refresh_token": "76***************85", "machine_code": "", "expires_in": 2592000, "refresh_expires_in": 3024000, "scope": "all" } ``` #### body 字段说明 |名称|类型|空|描述 |-|-|-|-| |client_id|string|否|应用id |access_token|string|否|授权凭证 |refresh_token|string|否|刷新凭证 |machine_code|string|是|终端号 |expires_in|string|否|调用凭证有效时间（秒） |refresh_expires_in|string|否|刷新凭证有效时间（秒） |scope|string|否|权限范围