第三方可通过如下接口,获取登录用户的信息。建议用户以返回信息中的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",
"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视为调用成功