第三方应用开发 服务端API 家校沟通 学生与家长管理 批量删除学生
批量删除学生
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
批量删除学生
最后更新:2023/11/30

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

请求包体:

{
	"useridlist": ["zhangsan", "lisi"]
}

参数说明:

参数必须说明
access_token调用接口凭证
useridlist学生的userid列表,每次最多100个
注意,如果学生还有家长,则不允许删除学生,必须先把家长删除

权限说明:

调用的应用需要满足如下的权限

应用类型权限要求
自建应用配置到「 家校沟通-读取和编辑家校通讯录的应用」中
第三方应用需拥有「家校沟通」使用和编辑 权限

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

{
	"errcode": 1111,
	"errmsg": "userid not found"
	"result_list": [
		{
			"student_userid": "lisi",
			"errcode": 1111,
			"errmsg": "userid not found"
		}
	]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
result_list批量操作结果
上一篇
批量创建学生
下一篇
批量更新学生