搜索
开发文档
应用开发
快应用开发
小游戏开发
开发文档/应用开发/服务能力/小米账号服务/访问令牌更新接口
访问令牌更新接口更新时间: 2024-09-25 19:56:00

温馨提示:一个刷新令牌只能用于更新一次访问令牌,我们会在更新下发访问令牌的同时,下发新的刷新令牌。

通过 refresh_token 更新 access_token

请求地址:  https://account.xiaomi.com/oauth2/token

请求方法:  GET

请求参数:

参数名称必须类型备注
client_idlong申请应用时分配的应用 ID,可以在应用详情页获取
redirect_uristring回调地址, 必须和申请应用是填写的一致(参数部分可不一致)
client_secretstring申请应用时分配的 AppSecret,需要 URLEncode
grant_typestring这里 grant_type=refresh_token
refresh_tokenstring授权码模式下发访问令牌时下发的刷新令牌,只可使用一次

返回值数据:

  • 成功响应

如果请求成功,授权服务器会返回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&&&可以直接去掉。


上一篇:
下一篇:
文档内容是否有帮助?
有帮助有帮助
无帮助无帮助