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

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

请求包体:

{
	"student_userid": "zhangsan",
	"mobile": "18000000000",
	"new_student_userid":"NEW_ID",
	"name": "张三",
	"department": [1, 2]
}

参数说明:

参数必须说明
access_token调用接口凭证。获取方法查看“获取access_token
student_userid学生UserID。学校内必须唯一。不区分大小写,长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成,且第一个字符必须是数字或字母。
mobile学生手机号
new_student_userid要变更的学生UserID,不能与已存在的UserID相同。每个学生仅能修改一次。
name学生姓名,长度为1~32个字符
department学生所在的班级id列表,不超过20个
当参数字段超过长度限制,那么整个请求会被拦掉。

权限说明:

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

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

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

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

返回结果:

{
   "errcode": 0,
   "errmsg": "updated"
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
上一篇
删除学生
下一篇
批量创建学生