批量更新学生

POST

/cgi-bin/school/user/batch_update_student

当参数字段超过长度限制，那么整个请求会被拦掉。

权限说明：

学校需要使用“家校沟通”secret所获取的accesstoken来调用（accesstoken如何获取？）；

第三方应用需拥有「家校沟通」使用和编辑权限。

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

请求参数

Query 参数

Body 参数application/json

示例

{
	"students":[
        {
			"student_userid": "zhangsan",
			"mobile": "10000000000",
			"new_student_userid":"zhangsan_new",
			"name": "张三",
			"department": [1, 2],
		},
        {
			"student_userid": "lisi",
			"mobile": "10000000000",
			"name": "李四",
			"department": [3, 4]
		}
     ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/cgi-bin/school/user/batch_update_student?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
	"students":[
        {
			"student_userid": "zhangsan",
			"mobile": "10000000000",
			"new_student_userid":"zhangsan_new",
			"name": "张三",
			"department": [1, 2],
		},
        {
			"student_userid": "lisi",
			"mobile": "10000000000",
			"name": "李四",
			"department": [3, 4]
		}
     ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 1,
    "errmsg": "invalid student_userid: zhangsan",
    "result_list": [
        {
            "student_userid": "zhangsan",
            "errcode": 1,
            "errmsg": "invalid student_userid: zhangsan"
        }
    ]
}

修改于 2025-03-26 09:11:31

批量删除学生

创建家长