开发文档
访问令牌更新接口更新时间: 2024-09-25 19:56:00
温馨提示:一个刷新令牌只能用于更新一次访问令牌,我们会在更新下发访问令牌的同时,下发新的刷新令牌。
通过 refresh_token 更新 access_token
请求地址: https://account.xiaomi.com/oauth2/token
请求方法: GET
请求参数:
参数名称 | 必须 | 类型 | 备注 |
client_id | 是 | long | 申请应用时分配的应用 ID,可以在应用详情页获取 |
redirect_uri | 是 | string | 回调地址, 必须和申请应用是填写的一致(参数部分可不一致) |
client_secret | 是 | string | 申请应用时分配的 AppSecret,需要 URLEncode |
grant_type | 是 | string | 这里 grant_type=refresh_token |
refresh_token | 是 | string | 授权码模式下发访问令牌时下发的刷新令牌,只可使用一次 |
返回值数据:
- 成功响应
如果请求成功,授权服务器会返回JSON格式的字符串:
参数名称 | 必须 | 类型 | 备注 |
access_token | 是 | string | 访问令牌 |
expires_in | 是 | long | 访问令牌生命周期(单位:秒) |
refresh_token | 是 | string | 更新后的刷新令牌 |
scope | 是 | string | 访问令牌实际权限范围 |
mac_key | 是 | string | MAC类型访问令牌对应的加密密钥 |
mac_algorithm | 是 | string | MAC类型访问令牌对应的加密算法,目前只支持HMacSha1 |
openId | 是 | string | 用户在APP内的唯一标识 |
返回值示例:
&&&START&&&{
"access_token": "access token value",
"expires_in": 7776000,
"refresh_token": "refresh token value",
"scope": "scope value",
"token_type ": "mac",
"mac_key ": "mac key value",
"mac_algorithm": " HmacSha1",
"openId":"2.0XXXXXXXXX"
}
注意: 前面的&&&START&&&
可以直接去掉。
- 失败响应
如果请求失败,授权服务器会返回 JSON 格式的字符串:
参数名称 | 必须 | 类型 | 备注 |
error | 是 | int | 错误码 |
error_description | 是 | string | 错误描述信息 |
返回值示例:
&&&START&&& {
"error": "error_code",
"error_description": "错误描述"
}
注意: 前面的&&&START&&&
可以直接去掉。
上一篇:
下一篇:
文档内容是否有帮助?
有帮助
无帮助