第三方应用开发 服务端API 家校沟通 学生与家长管理 获取部门成员详情
获取部门成员详情

请求方式:GET(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/user/list?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID&fetch_child=FETCH_CHILD

参数说明:

参数必须说明
access_token调用接口凭证
department_id获取的部门id
fetch_child1/0:是否递归获取子部门下面的成员

 

权限说明:

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"students":[
		{
			"student_userid": "zhangsan",
			"name": "张三",
			"department": [1, 2],
			"parents": [
				{
					"parent_userid": "zhangsan_parent1",
					"relation": "爸爸",
					"mobile": "18000000001",
					"is_subscribe": 1,
					"external_userid":"xxx"
				},
				{
					"parent_userid": "zhangsan_parent2",
					"relation": "妈妈",
					"mobile": "18000000002",
					"is_subscribe": 0
				}
			]
		},
		{
			"student_userid": "lisi",
			"name": "李四",
			"department": [4, 5],
			"parents": [
				{
					"parent_userid": "lisi_parent1",
					"relation": "爷爷",
					"mobile": "18000000003",
					"is_subscribe": 1,
					"external_userid":"xxx"
				},
				{
					"parent_userid": "lisi_parent2",
					"relation": "妈妈",
					"mobile": "18000000004",
					"is_subscribe": 1,
					"external_userid":"xxx"
				}
			]
		}
	]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
students学生列表
students.student_userid学生UserID
students.name学生名字
students.department学生所在的班级id列表,不超过20个
students.parents学生家长列表
students.parents.parent_userid家长的userid
students.parents.relation学生与家长的关系
students.parents.mobile家长手机号,第三方不可获取
students.parent.is_subscribe家长是否关注了“学校通知”,0-未关注,1-已关注
students.parent.external_userid家长的external_userid,仅当家长已关注才返回。对同一个服务商来说,同一个家长微信在不同学校下返回的家长的external_userid是一样的
上一篇
读取学生或家长
下一篇
设置家校通讯录自动同步模式