获取登录用户信息

第三方可通过如下接口,获取登录用户的信息。建议用户以返回信息中的corpid及userid为主键匹配用户。

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/service/get_login_info?access_token=PROVIDER_ACCESS_TOKEN

请求包体:

 {
    "auth_code":"xxxxx"
 }

参数说明:

参数 是否必须 说明
access_token 授权登录服务商的网站时,使用应用提供商的provider_access_token,获取方法参见服务商的凭证
auth_code oauth2.0授权企业微信管理员登录产生的code,最长为512字节。只能使用一次,5分钟未被使用自动过期

返回结果:

{
   "errcode":0,
   "errmsg":"ok",
   "usertype": 1,
   "user_info":{
       "userid":"xxxx",
       "name":"xxxx",
       "avatar":"xxxx"
   },
   "corp_info":{
       "corpid":"wxCorpId",
    },
   "agent":[
       {"agentid":0,"auth_type":1},
       {"agentid":1,"auth_type":1},
       {"agentid":2,"auth_type":1}
   ],
   "auth_info":{
       "department":[
           {
               "id":2,
               "writable":true
           }
       ]
   }
}

参数说明:

参数 说明
errcode 返回码。
若返回该字段,并且errcode!=0,为调用失败;
无此errcode字段,或者errcode=0,为调用成功
errmsg 对返回码的文本描述内容。仅当errcode字段返回时,同时返回errmsg
usertype 登录用户的类型:1.创建者 2.内部系统管理员 3.外部系统管理员 4.分级管理员 5.成员
user_info 登录用户的信息
userid 登录用户的userid,登录用户在通讯录中时返回
name 登录用户的名字,登录用户在通讯录中时返回,此字段从2019年12月30日起,对新创建服务商不再返回,2020年6月30日起,对所有历史服务商不再返回,第三方页面需要通过通讯录展示组件来展示名字
avatar 登录用户的头像,登录用户在通讯录中时返回
corp_info 授权方企业信息
corpid 授权方企业id
agent 该管理员在该提供商中能使用的应用列表,当登录用户为管理员时返回
agentid 应用id
auth_type 该管理员对应用的权限:1.管理权限,0.使用权限
auth_info 该管理员拥有的通讯录权限,当登录用户为管理员时返回
© 1998 - 2020 Tencent Inc. All Rights Reserved