# 预授权code获取user_access_token及用户信息

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

# 请求

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

# 请求头

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

# 请求体

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

# 请求体示例

{
  "grant_type": "authorization_code",
  "code": "xMSldislSkdK"
}
1
2
3
4

# 响应

# 响应体

名称 类型 描述
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"
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
最后更新于 : 10/27/2023, 4:03:39 PM