创建部门

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 参数

Body 参数application/json

示例

{
    "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": 0,
    "errmsg": "string",
    "id": 0
}

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

获取部门家长详情

更新部门