刷新 user_access_token

user_access_token 的最大有效期是 7200 秒。当 user_access_token 过期时，可以调用本接口获取新的 user_access_token。

请求

基本
HTTP URL	https://hi-gw.weizhipin.com/open-apis/authen/refresh_access_token
HTTP Method	POST
支持的应用类型	自建应用
权限要求	无
字段权限要求	该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请： 获取用户邮箱信息 获取用户 user ID 获取用户手机号

请求头

名称	类型	必填	描述
Authorization	string	是	app_access_token 自建应用调用自建应用获取 app_access_token接口获取； 值格式："Bearer access_token" 示例值："Bearer a-7f1bcd13fc57d46bac21793a18e560"
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
grant_type	string	是	授权类型 固定值："refresh_token"
refresh_token	string	是	刷新 user_access_token 需要的凭证 获取 user_access_token接口和本接口均返回 refresh_token，请使用最新获取到的 示例值："ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL"

请求体示例

{
  "grant_type": "refresh_token",
  "refresh_token": "ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	user_access_token_info	-
∟access_token	string	user_access_token，用于获取用户资源
∟token_type	string	token 类型
∟expires_in	int	access_token 的有效期，单位: 秒
∟name	string	用户姓名
∟avatar_url	string	用户头像
∟open_id	string	用户在应用内的唯一标识
∟union_id	string	用户统一ID
∟email	string	用户邮箱 字段权限要求： 获取用户邮箱信息
∟user_id	string	用户 user_id 字段权限要求： 获取用户 user ID
∟mobile	string	用户手机号 字段权限要求： 获取用户手机号
∟tenant_key	string	当前企业标识
∟refresh_expires_in	int	refresh_token 的有效期，单位: 秒
∟refresh_token	string	刷新用户 access_token 时使用的 token

响应体示例

{
  "code": 0,
  "traceId": "_Ao59UOIBLPCeAAu",
  "msg": "success",
  "data": {
    "access_token": "u-Q7JWnaIM_kRChuLfreHmpArjOEayt.5XUBJcZr.V0Gst4FdQCtvrd9sAViLXQnQgkpL19brGOjKZQTxb",
    "token_type": "Bearer",
    "expires_in": 7140,
    "name": "zhangsan",
    "avatar_url": "www.zhipin.com/avatar/icon",
    "open_id": "ou_caecc734c2e3328a62489fe0648c4b98779515d3",
    "union_id": "on_d89jhsdhjsajkda7828enjdj328ydhhw3u43yjhdj",
    "email": "zhangsan@zhipin.com",
    "enterprise_email": "demo@mail.com",
    "user_id": "5d9bdxxx",
    "mobile": "+86130002883xx",
    "tenant_key": "736588c92lxf175d",
    "refresh_expires_in": 2591940,
    "refresh_token": "ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL"
  }
}