更新部门

POST

/cgi-bin/school/department/update

注意，班级的父部门必须是年级，也就是说type为1的部门的父部门type值必须是2。
当传入的standard_grade为0时，表示将此部门转换为非标准年级。
管理员类型须与部门类型保持一致，即校区负责人只能配置到校区部门，班主任和任课老师只能设置到班级。
权限说明：学校需要使用“家校沟通”secret所获取的accesstoken来调用（accesstoken如何获取？）；第三方应用需拥有「家校沟通」使用和编辑权限。

文档ID: 18837
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92297
https://open.work.weixin.qq.com/api/doc/90000/90135/92341

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/school/department/update?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"name":"一年级","parentid":5,"id":2,"register_year":2018,"standard_grade":1,"order":1,"new_id":100,"department_admins":[{"op":0,"userid":"zhangsan","type":3,"subject":"语文"},{"op":1,"userid":"lisi","type":4,"subject":"数学"}]}'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

register_year

integer <int32>

可选

入学年份，32位整型，格式为YYYY，输入范围为1970～2100，仅当部门类型为年级（2）时生效

standard_grade

integer <int32>

可选

标准年级，32位整型，参数值含义详见标准年级对照表，仅当部门类型为年级（2）时生效

new_id

integer <int32>

修改为新的id

可选

name

string

可选

部门名称，如果部门为标准年级则忽略该字段。长度限制为1~32个字符，字符不能包括-:?”<>/，

department_admins

array [object {4}]

部门管理员列表

可选

integer <int32>

必需

op=0表示新增或者更新，op=1表示删除管理员

subject

string

可选

部门管理员类型， 1表示校区负责人，2表示年级负责人，3表示班主任，4表示任课老师，5表示学段负责人

type

integer <int32>

可选

教师的科目，仅班主任和任课老师可以设置，科目的最多15个字符，仅支持设置一个科目

userid

string

必需

对应管理端的帐号，企业内必须唯一。不区分大小写，长度为1~64个字节

integer <int32>

必需

部门id，32位整型，必须大于0。

parentid

integer <int32>

可选

父部门id，32位整型

order

integer <int32>

可选

在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

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

创建部门

删除部门