获取家校访问用户身份 - 接口文档

第三方应用开发服务端API 家校沟通网页授权登录获取家校访问用户身份

获取家校访问用户身份

最后更新：2022/05/24

请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/service/school/getuserinfo3rd?suite_access_token=SUITE_ACCESS_TOKEN&code=CODE

参数说明：

参数	必须	说明
suite_access_token	是	第三方应用的suite_access_token，参见“获取第三方应用凭证”
code	是	通过成员授权获取到的code，最大为512字节。每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。

权限说明：
跳转的域名须完全匹配access_token对应第三方应用的可信域名，否则会返回50001错误。

返回结果：
a) 当用户为学校的家长时，返回示例如下：

{
   "errcode": 0,
   "errmsg": "ok",
   "parents":[
		{
			"corpid": "wxCorpId1",
			"parent_userid": "zhangsan"
		},
		{
			"corpid": "wxCorpId2",
			"parent_userid": "lisi"
		}
   ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
DeviceId	手机设备号(由企业微信在安装时随机生成，删除重装会改变，升级不受影响)
parents	家长列表
parents.corpid	家长所在学校的corpid
parents.parent_userid	家长在家校通讯录里的parent_userid

b) 当用户为学校的学生时，返回示例如下：

{
   "errcode": 0,
   "errmsg": "ok",
   "students":[
		{
			"corpid": "wxCorpId1",
			"student_userid": "zhangsan"
		},
		{
			"corpid": "wxCorpId2",
			"student_userid": "lisi"
		}
   ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
DeviceId	手机设备号(由企业微信在安装时随机生成，删除重装会改变，升级不受影响)
students	学生列表
students.corpid	学生所在学校的corpid
students.student_userid	学生在家校通讯录里的student_userid

出错返回示例：

{
   "errcode": 40029,
   "errmsg": "invalid code"
}

获取访问用户身份

创建学生

本节内容

获取家校访问用户身份