请求方式: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 |
返回结果:
{
"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是一样的 |