刷新用户access_token
请求说明
| 请求地址 | {配置域名}/openapi/oauth2/token |
|---|---|
| 请求方法 | POST |
| 权限要求 | 无 |
请求头
| Header名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | string | 是 | 使用:application/x-www-form-urlencoded |
请求体(Body)
| 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| grant_type | string | 是 | 授权类型,使用:refresh_token |
| refresh_token | string | 是 | refresh_token 的值 |
| client_id | string | 是 | 应用 APPID |
| client_secret | string | 是 | 在HTTPs环境下,可为明文应用 APPKEY;在非HTTPs环境下,为保证client_secret安全传输,需要进行加密处理,可参考《client_secret加密处理说明》 |
请求地址示例
json
[POST] {配置域名}/openapi/oauth2/token请求体示例
json
// Content-Type: application/x-www-form-urlencoded
// 数据示例
grant_type=refresh_token&refresh_token=YJM4ZWU**********&client_id=AK2024*********&client_secret=6*********接口成功响应体
📌 请注意: refresh_token 有效期为 90 天,当 refresh_token 失效之后,需要用户重新授权。 使用 refresh_token 刷新 access_token 时,会返回一个新的 refresh_token,原 refresh_token 自动失效。
| 名称 | 参数类型 | 说明 |
|---|---|---|
| access_token | string | 授权 token |
| expires_in | integer | 授权 token 有效时长,单位:秒 |
| refresh_token | string | 用户刷新 token |
| refresh_expires_in | integer | 用户刷新 token 有效时长,单位:秒 |
| token_type | string | token 类型,一般为 Bearer |
接口失败响应体
| 名称 | 参数类型 | 说明 |
|---|---|---|
| code | integer | 错误码。非 0 表示失败,参照《状态码说明》 |
| msg | string | 错误信息 |
响应体示例
json
// Content-Type: application/json
{
"access_token": "eyJhb******B7Re55MYSo",
"expires_in": 86400,
"refresh_token": "YJM4ZWU******QYZWI5",
"refresh_expires_in": 7776000,
"token_type": "Bearer"
}