创建部门

POST

http://127.0.0.1/cgi-bin/school/department/create

第三方应用开发/家校沟通/部门管理

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

责任人：未设置

注意，班级的父部门必须是年级，也就是说type为1的部门的父部门type值必须是2。如果创建的标准年级为小学二年级，当前为2019年，则系统默认的入学年份为2018年，依次类推。管理员类型须与部门类型保持一致，即校区负责人只能配置到校区部门，班主任和任课老师只能设置到班级。

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

文档ID: 18816
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92296
https://open.work.weixin.qq.com/api/doc/90000/90135/92340

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

register_year

integer <int32>

可选

入学年份，32位整型，格式为YYYY，输入范围为1970～2100，仅当部门类型为年级（2）时生效，如果在创建标准年级时不填此参数，则由系统自动计算出入学年份

standard_grade

integer <int32>

可选

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

name

string

可选

部门名称。长度限制为1~32个字符，字符不能包括-:?”<>/，，当设置了入学年份和标准年级时，该参数将被忽略

department_admins

array [object {3}]

部门管理员列表

可选

subject

string

可选

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

type

integer <int32>

可选

部门类型，32位整型，1表示班级，2表示年级，3表示学段，4表示校区

userid

string

可选

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

integer <int32>

可选

部门id，32位整型，指定时必须大于1。若不填该参数，将自动生成id

type

integer <int32>

必需

部门类型，32位整型，1表示班级，2表示年级，3表示学段，4表示校区

parentid

integer <int32>

必需

父部门id，32位整型

order

integer <int32>

可选

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

示例

{
  "name": "一年级",
  "parentid": 5,
  "id": 2,
  "type": 1,
  "register_year": 2018,
  "standard_grade": 1,
  "order": 1,
  "department_admins": [
    {
      "userid": "zhangsan",
      "type": 4,
      "subject": "语文"
    },
    {
      "userid": "lisi",
      "type": 3,
      "subject": "数学"
    }
  ]
}

示例代码

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/department/create?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "一年级",
    "parentid": 5,
    "id": 2,
    "type": 1,
    "register_year": 2018,
    "standard_grade": 1,
    "order": 1,
    "department_admins": [
        {
            "userid": "zhangsan",
            "type": 4,
            "subject": "语文"
        },
        {
            "userid": "lisi",
            "type": 3,
            "subject": "数学"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

integer <int32>

创建的部门id

可选

示例

{
  "errcode": 0,
  "errmsg": "string",
  "id": 0
}

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

获取部门家长详情

更新部门