企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
家校沟通
网页授权登录
获取访问用户身份
获取访问用户身份
最后更新:2023/01/12

该接口用于根据code获取成员信息

请求方式:GET(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/auth/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
参数说明:

参数必须说明
access_token调用接口凭证
code通过成员授权获取到的code,最大为512字节。每次成员授权带上的code将不一样,code只能使用一次,5分钟未被使用自动过期。

权限说明:
跳转的域名须完全匹配access_token对应应用的可信域名,否则会返回50001错误。
返回结果:
a) 当用户为企业成员时返回示例如下:

{
   "errcode": 0,
   "errmsg": "ok",
   "userid":"userid"
}
参数说明
errcode返回码
errmsg对返回码的文本描述内容
userid成员UserID。若需要获得用户详情信息,可调用通讯录接口:读取成员

b) 当用户为学校的家长时,返回示例如下:

{
   "errcode": 0,
   "errmsg": "ok",
   "external_userid": "abcexuserid",
   "parent_userid": "parent_userid"
}
参数说明
errcode返回码
errmsg对返回码的文本描述内容
external_userid家长的外部联系人id
parent_userid家校通讯录里家长的userid,如果是局校互联,则返回的parent_userid格式如:CorpId/parent_userid

 

c) 非企业成员或学生家长授权时返回示例如下:

{
   "errcode": 0,
   "errmsg": "ok",
   "openid":"OPENID"
}
参数说明
errcode返回码
errmsg对返回码的文本描述内容
openid非企业成员的标识,对当前企业唯一

 

出错返回示例:

{
   "errcode": 40029,
   "errmsg": "invalid code"
}
上一篇构造网页授权链接
下一篇获取家校访问用户身份
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们