# 刷新 user_access_token

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

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/authen/v1/refresh_access_token
HTTP Method | POST
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 无
字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请<br>获取用户邮箱信息(contact:user.email:readonly)<br>获取用户 user ID(contact:user.employee_id:readonly)<br>获取用户手机号(contact:user.phone:readonly)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `app_access_token`<br>自建应用调用[自建应用获取 app_access_token](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/app_access_token_internal)接口获取；商店应用调用[商店应用获取 app_access_token](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/app_access_token)接口获取<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer a-7f1bcd13fc57d46bac21793a18e560"
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
grant_type | string | 是 | 授权类型<br>**固定值**："refresh_token"
refresh_token | string | 是 | 刷新 `user_access_token` 需要的凭证<br>[获取 user_access_token](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/authen-v1/authen/access_token)接口和本接口均返回 `refresh_token`，请使用最新获取到的<br>**示例值**："ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL"

### 请求体示例

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

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | user_access_token_info | \-
&emsp;∟&nbsp;access_token | string | user_access_token，用于获取用户资源
&emsp;∟&nbsp;token_type | string | token 类型
&emsp;∟&nbsp;expires_in | int | access_token 的有效期，单位: 秒
&emsp;∟&nbsp;name | string | 用户姓名
&emsp;∟&nbsp;en_name | string | 用户英文名称
&emsp;∟&nbsp;avatar_url | string | 用户头像
&emsp;∟&nbsp;avatar_thumb | string | 用户头像 72x72
&emsp;∟&nbsp;avatar_middle | string | 用户头像 240x240
&emsp;∟&nbsp;avatar_big | string | 用户头像 640x640
&emsp;∟&nbsp;open_id | string | 用户在应用内的唯一标识
&emsp;∟&nbsp;union_id | string | 用户统一ID
&emsp;∟&nbsp;email | string | 用户邮箱<br>**字段权限要求**：<br>获取用户邮箱信息(contact:user.email:readonly)
&emsp;∟&nbsp;user_id | string | 用户 user_id<br>**字段权限要求**：<br>获取用户 user ID(contact:user.employee_id:readonly)
&emsp;∟&nbsp;mobile | string | 用户手机号<br>**字段权限要求**：<br>获取用户手机号(contact:user.phone:readonly)
&emsp;∟&nbsp;tenant_key | string | 当前企业标识
&emsp;∟&nbsp;refresh_expires_in | int | refresh_token 的有效期，单位: 秒
&emsp;∟&nbsp;refresh_token | string | 刷新用户 access_token 时使用的 token

### 响应体示例

```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "access_token": "u-Q7JWnaIM_kRChuLfreHmpArjOEayt.5XUBJcZr.V0Gst4FdQCtvrd9sAViLXQnQgkpL19brGOjKZQTxb",
        "token_type": "Bearer",
        "expires_in": 7140,
        "name": "zhangsan",
        "en_name": "Three Zhang",
        "avatar_url": "www.feishu.cn/avatar/icon",
        "avatar_thumb": "www.feishu.cn/avatar/icon_thumb",
        "avatar_middle": "www.feishu.cn/avatar/icon_middle",
        "avatar_big": "www.feishu.cn/avatar/icon_big",
        "open_id": "ou_caecc734c2e3328a62489fe0648c4b98779515d3",
        "union_id": "on_d89jhsdhjsajkda7828enjdj328ydhhw3u43yjhdj",
        "email": "zhangsan@feishu.cn",
        "user_id": "5d9bdxxx",
        "mobile": "+86130002883xx",
        "tenant_key": "736588c92lxf175d",
        "refresh_expires_in": 2591940,
        "refresh_token": "ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL"
    }
}
```

### 错误码

有关错误码的详细介绍，请参考[通用错误码](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN)介绍。