获取 user_access_token（v1 版本，仅字节）

Error: 本接口已成为历史版本，不推荐使用。请使用最新版本：获取 user_access_token

。

Warning: 2024年9月19日起，字节内新创建的企业自建应用将默认无法通过「获取 user_access_token」接口获取 refresh_token，需在应用开发者后台安全设置中开启「刷新 user_access_token」开关后方可正常获取和刷新。9月19日前创建的企业自建应用暂不受影响，可通过原接口直接获取和刷新。

根据登录预授权码 code 获取 user_access_token。

Tip: 本接口用于网页应用免登录应用场景，小程序应用获取 user_access_token 的方法，请参考小程序应用提供的 code2session 接口。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/authen/v1/access_token
HTTP Method	POST
接口频率限制	特殊频控
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	无
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee:readonly 获取用户受雇信息 contact:user.email:readonly 获取用户邮箱信息 contact:user.employee_id:readonly 获取用户 user ID contact:user.phone:readonly 获取用户手机号

请求头

名称	类型	必填	描述
Authorization	string	是	app_access_token 值格式："Bearer access_token" 示例值："Bearer a-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
grant_type	string	是	授权类型，固定值： 示例值："authorization_code"
code	string	是	登录预授权码，调用获取登录预授权码接口获取 示例值："xMSldislSkdK"

请求体示例

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

响应

响应体

名称	类型	描述
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	用户姓名
└ en_name	string	用户英文名称
└ avatar_url	string	用户头像
└ avatar_thumb	string	用户头像 72x72
└ avatar_middle	string	用户头像 240x240
└ avatar_big	string	用户头像 640x640
└ open_id	string	用户在应用内的唯一标识
└ union_id	string	用户统一ID
└ email	string	用户邮箱 字段权限要求： contact:user.email:readonly 获取用户邮箱信息
└ enterprise_email	string	企业邮箱，请先确保已在管理后台启用飞书邮箱服务 字段权限要求： contact:user.employee:readonly 获取用户受雇信息
└ user_id	string	用户 user_id 字段权限要求： contact:user.employee_id:readonly 获取用户 user ID
└ mobile	string	用户手机号 字段权限要求： contact:user.phone:readonly 获取用户手机号
└ tenant_key	string	当前企业标识
└ refresh_expires_in	int	refresh_token 的有效期，单位: 秒
└ refresh_token	string	刷新用户 access_token 时使用的 token
└ sid	string	用户当前登录态session的唯一标识，为空则不返回

响应体示例

{
    "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",
        "sid": "AAAAAAAAAANjgHsqKEAAEw=="
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
200	20001	Invalid request. Please check request param	请检查请求参数
200	20007	Failed to generate a user access token. Please try again	生成失败，请检查参数是否有效，重试
200	20008	User not exist	用户不存在，换有效帐号
200	20009	Tenant does not install app	租户没有安装app，请联系租户管理员安装
200	20021	User resigned	用户离职，请使用有效帐号
200	20022	User frozen	用户冻结，请使用有效帐号
200	20023	User not registered	用户未注册，请使用有效帐号
200	20024	App id in user_access_token or refresh_token diff with app id in app_access_token or tenant_access_token. Please keep the app id consistent	请检查生成两个token的app是否为同一个
200	20025	Lack of app_id or app_secret in request	缺失app_id或app_secret，请检查参数
200	20028	Invalid app id	无效app_id，请检查参数
500	20050	System error	系统错误，请重试