批量创建学生

POST

http://127.0.0.1/cgi-bin/school/user/batch_create_student

最后修改时间：2022-08-30 03:03:36

责任人：未设置

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

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

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

文档ID: 18904
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92037
https://open.work.weixin.qq.com/api/doc/90000/90135/92328

请求参数

Query 参数

Body 参数application/json

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "errmsg": "string",
    "result_list": [
        {
            "errcode": 0,
            "student_userid": "string",
            "errmsg": "string"
        }
    ]
}

修改于 2022-08-30 03:03:36

更新学生

批量删除学生