登录
第三方应用开发 服务端API 家校沟通 学生与家长管理 获取部门家长详情
获取部门家长详情
请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/school/user/list_parent?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| department_id | 是 | 获取的部门id |
- 学校需要使用“家校沟通”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。
- 第三方应用需拥有「家校沟通」使用权限。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"parents": [
{
"parent_userid": "zhangsan_parent",
"mobile": "18900000000",
"is_subscribe": 1,
"external_userid":"xxx",
"children": [
{
"student_userid": "zhangsan",
"relation": "爸爸",
"name": "张三"
}
]
},
{
"parent_userid": "lisi_parent",
"mobile": "18900000001",
"is_subscribe": 0,
"children": [
{
"student_userid": "lisi",
"relation": "妈妈",
"name": "李四"
}
]
}
]
}参数说明:
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| parents.parent_userid | 家长的userid |
| parents.mobile | 家长手机号，第三方不可获取;代开发应用需要管理员授权该权限才返回 |
| parents.is_subscribe | 家长是否关注了“学校通知”，0-未关注，1-已关注 |
| parents.children | 家长孩子列表 |
| parents.children.student_userid | 学生的userid |
| parents.children.relation | 家长与学生关系 |
| parents.children.name | 学生姓名 |
| parents.external_userid | 家长的external_userid,仅当家长已关注才返回。对同一个服务商来说，同一个家长微信在不同学校下返回的家长的external_userid是一样的 |
- 获取部门家长详情
本节内容
