批量更新家长 - 企业微信 API

权限说明：学校需要使用“家校沟通”secret所获取的accesstoken来调用（accesstoken如何获取？）；第三方应用需拥有「家校沟通」使用和编辑权限。

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

文档ID: 19149
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92082
https://open.work.weixin.qq.com/api/doc/90000/90135/92336

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/school/user/batch_update_parent?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{"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":"妈妈"}]}]}'

{ "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" } ] }

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

parents

array [object {4}]

必需

家长列表，每次最多100个

parent_userid

string

必需

家长UserID。学校内必须唯一。不区分大小写，长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成，且第一个字符必须是数字或字母。

children

array [object {2}]

可选

家长的孩子列表，最多10个

mobile

string

家长手机号

可选

new_parent_userid

string

必需

更新的家长UserID。不能与已经存在的家长userid相同。每个家长仅能更新一次。

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

result_list

array [object {3}]

失败的学生列表

可选

errcode

integer <int32>

返回码

可选

parent_userid

string

可选

errmsg

string

可选

对返回码的文本描述内容