第三方应用开发 服务端API 家校沟通 学生与家长管理 批量更新家长
批量更新家长

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/user/batch_update_parent?access_token=ACCESS_TOKEN

请求包体:

{
    "parents":[
        {   
            "parent_userid": "zhangsan_baba",
			"new_parent_userid":"zhangsan_baba_new",
            "mobile": "10000000000",
            "children":[
                {   
                    "student_userid": "zhangsan",
                    "relation": "爸爸"
                }   
            ]   
        },  
        {   
            "parent_userid": "lisi_mama",
            "mobile": "10000000001",
            "children":[
                {
                    "student_userid": "lisi",
                    "relation": "妈妈"
                }   
            ]   
        }   
    ]   
}

参数说明:

参数必须说明
access_token调用接口凭证。获取方法查看“获取access_token
parents家长列表,每次最多100个
parents.parent_userid家长UserID。学校内必须唯一。不区分大小写,长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成,且第一个字符必须是数字或字母。
parents.new_parent_userid更新的家长UserID。不能与已经存在的家长userid相同。每个家长仅能更新一次。
parents.mobile家长手机号
parents.children家长的孩子列表,最多10个
parents.children.student_userid学生的UserID
parents.children.relation家长与学生的关系,最长32字节
当参数字段超过长度限制,那么整个请求会被拦掉。

权限说明:

注意,每个班级下学生总数不能超过3万个。建议保证创建department对应的部门和创建成员是串行化处理。

返回结果:

{
	"errcode": 1,
	"errmsg": "invalid parent_userid: lisi_parent_userid",
	"result_list": [
		{
			"parent_userid": "lisi_parent_userid",
			"errcode": 1,
			"errmsg": "invalid parent_userid: lisi_parent_userid",
		}
	]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
result_list失败的学生列表
result_list.parent_userid失败的家长userid
result_list.errcode返回码
result_list.errmsg对返回码的文本描述内容

 

上一篇
批量删除家长
下一篇
读取学生或家长