批量删除学生

POST

/cgi-bin/school/user/batch_delete_student

服务端API第三方应用开发企业内部开发

注意，如果学生还有家长，则不允许删除学生，必须先把家长删除

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

文档ID: 18834
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92040
https://open.work.weixin.qq.com/api/doc/90000/90135/92329

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/school/user/batch_delete_student?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"useridlist":["zhangsan","lisi"]}'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

useridlist

array[string]

必需

学生的userid列表，每次最多100个

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

result_list

array [object {3}]

批量操作结果

可选

errcode

integer <int32>

返回码

可选

student_userid

string

可选

errmsg

string

可选

对返回码的文本描述内容

修改于 2022-01-14 04:25:45

批量创建学生

批量更新学生