第三方应用开发 服务端API 身份验证 扫码授权登录 获取登录用户信息
获取登录用户信息

第三方可通过如下接口,获取登录用户的信息。建议用户以返回信息中的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_codeoauth2.0授权企业微信管理员登录产生的code,最长为512字节。只能使用一次,5分钟未被使用自动过期

返回结果:

{
   "errcode":0,
   "errmsg":"ok",
   "usertype": 1,
   "user_info":{
       "userid":"xxxx",
	   "open_userid":"xxx",
       "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,登录用户在通讯录中时返回
open_userid全局唯一。对于同一个服务商,不同应用获取到企业内同一个成员的open_userid是相同的,最多64个字节。 登录用户在通讯录中返回
name登录用户的名字,登录用户在通讯录中时返回,此字段从2019年12月30日起,对新创建服务商不再返回,2020年6月30日起,对所有历史服务商不再返回真实name,使用userid代替name返回,第三方页面需要通过通讯录展示组件来展示名字
avatar登录用户的头像。该字段已废弃,不再返回用户真实头像
corp_info授权方企业信息
corpid授权方企业id
agent该管理员在该提供商中能使用的应用列表,当登录用户为管理员时返回
agentid应用id
auth_type该管理员对应用的权限:1.管理权限,0.使用权限
auth_info该管理员拥有的通讯录权限,当登录用户为管理员时返回


注意:因历史原因,该接口在调用失败时才返回errcode。没返回errcode视为调用成功

上一篇
接入指引
下一篇
概述