Skip to content

刷新用户access_token

请求说明

请求地址{配置域名}/openapi/oauth2/token
请求方法POST
权限要求

请求头

Header名称参数类型是否必填说明
Content-Typestring使用:application/x-www-form-urlencoded

请求体(Body)

名称参数类型是否必填说明
grant_typestring授权类型,使用:refresh_token
refresh_tokenstringrefresh_token 的值
client_idstring应用 APPID
client_secretstring在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_tokenstring授权 token
expires_ininteger授权 token 有效时长,单位:秒
refresh_tokenstring用户刷新 token
refresh_expires_ininteger用户刷新 token 有效时长,单位:秒
token_typestringtoken 类型,一般为 Bearer

接口失败响应体

名称参数类型说明
codeinteger错误码。非 0 表示失败,参照《状态码说明》
msgstring错误信息

响应体示例

json
// Content-Type: application/json

{
  "access_token": "eyJhb******B7Re55MYSo",
  "expires_in": 86400,
  "refresh_token": "YJM4ZWU******QYZWI5",
  "refresh_expires_in": 7776000,
  "token_type": "Bearer"
}