# 获取 user_access_token

根据[登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN) code 获取 `user_access_token`。
**说明：** 本接口用于网页应用免登录应用场景，小程序应用获取 user_access_token 的方法，请参考小程序应用提供的 [code2session](https://open.feishu.cn/document/uYjL24iN/ukjM04SOyQjL5IDN) 接口。

## 请求

基本 | &nbsp;
---|---
HTTP URL | https://open.feishu.cn/open-apis/authen/v1/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)<br>获取用户雇佣信息(contact:user.employee: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>**固定值**："authorization_code"
code | string | 是 | 登录预授权码，调用[获取登录预授权码](https://open.feishu.cn/document/ukTMukTMukTM/ukzN4UjL5cDO14SO3gTN)接口获取<br>**示例值**："xMSldislSkdK"

### 请求体示例

```json
{
    "grant_type": "authorization_code",
    "code": "xMSldislSkdK"
}
```

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
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;enterprise_email | string | 企业邮箱，请先确保已在管理后台启用飞书邮箱服务<br>**字段权限要求（满足任一）**：<br>获取用户雇佣信息(contact:user.employee: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",
        "enterprise_email": "demo@mail.com",
        "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)介绍。

