刷新 user_access_token

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

字段权限要求：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请

curl --location --request POST 'https://open.feishu.cn/open-apis/authen/v1/refresh_access_token' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "grant_type": "refresh_token", "refresh_token": "ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL" }'

{ "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==" } }

请求参数

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

grant_type

string

必需

授权类型，固定值示例值："refresh_token"

refresh_token

string

必需

刷新 user_access_token 需要的凭证获取user_access_token接口和本接口均返回 refresh_token，每次请求，请注意使用最新获取到的refresh_token 示例值："ur-oQ0mMq6MCcueAv0pwx2fQQhxqv__CbLu6G8ySFwafeKww2Def2BJdOkW3.9gCFM.LBQgFri901QaqeuL"

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

access_token

string

必需

user_access_token，用于获取用户资源

token_type

string

token 类型

必需

expires_in

integer

必需

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

必需

string

必需

用户邮箱。字段权限要求：获取用户邮箱信息

enterprise_email

string

必需

企业邮箱，请先确保已在管理后台启用飞书邮箱服务。字段权限要求：获取用户受雇信息

user_id

string

必需

用户 user_id。字段权限要求：获取用户 user ID

mobile

string

必需

用户手机号。字段权限要求：获取用户手机号

tenant_key

string

当前企业标识

必需

refresh_expires_in

integer

必需

refresh_token 的有效期，单位: 秒

refresh_token

string

必需

刷新用户 access_token 时使用的 token

sid

string

必需

用户当前登录态session的唯一标识，为空则不返回