创建部门

使用场景： 调用本接口，创建校区、学段、年级或班级，用于学年开始时的数据初始化。创建后会返回部门的ID，可以继续作为参数来创建下一级的部门。一般情况下，使用/school/department/list获取到家校部门后，可以取出Level=0（一般为首条数据）的根节点，来创建校区，然后根据校区的部门ID来创建学段，根据学段ID来创建年级，根据年级ID来创建班级。其中班级必须是在年级下边的，年级则可以在根节点、校区、学段任一级别下。

权限说明

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/school/department/create

Query参数:

Body参数：

返回参数：

请求示例：

POST https://test-oapi.epaas.qq.com/school/department/create?access_token=ACCESS_TOKEN

请求包体：

{
    "name": "一年级",
    "parentid": 1,
    "order": 1,
    "tag": 5,
    "department_type":4,
    "register_year": 2020,
    "standard_grade": 1,
    "custom_grade": 0,
    "code": "2020ynj",
    "org_attribute":0,
    "department_admins": [
        {
            "userid": "123",
            "type": 3,
            "subject": "语文",
            "subject_code": "P001"
        },
        {
            "userid": "456",
            "type": 4,
            "subject": "数学",
            "subject_code": "P001"
        }
    ]
}

返回示例：

{   
    "errcode": 0,   
    "errmsg": "ok",
    "id": 2
}

修改部门

使用场景： 修改指定部门的数据，可以迁移部门节点到同样类型的父部门下边，也可以增删改班级类型的部门管理员，更新和删除部门管理员是以userid和type作为判断依据的。

权限说明

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/school/department/update

Query参数:

Body参数：

返回参数：

请求示例：

POST https://test-oapi.epaas.qq.com/school/department/update?access_token=ACCESS_TOKEN

请求包体：

{
    "id": 2,
    "name": "一年级",
    "parentid": 1,
    "order": 1,
    "code": "ynj",
    "org_attribute":0,
    "custom_grade": 0,
    "register_year":2022,
    "department_admins": [
        {
            "op": 0,
            "userid": "123",
            "type": 3,
            "subject": "语文",
            "subject_code": "P001"
        },
        {
            "op": 1,
            "userid": "456",
            "type": 4,
            "subject": "数学",
            "subject_code": "P002"
        }
    ]
}

返回示例：

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

删除部门

使用场景： 调用本接口，删除指定部门，部门下不能含有子部门或学生。

权限说明

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/school/department/delete

Query参数:

返回参数：

请求示例：

GET https://test-oapi.epaas.qq.com/school/department/delete?access_token=ACCESS_TOKEN&id=ID

返回示例：

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

班级毕业

使用场景： 调用本接口，令班级所有学生毕业，成为毕业生。

权限说明

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/school/department/graduate

Query参数:

Body参数：

返回参数：

请求示例：

POST https://test-oapi.epaas.qq.com/school/department/graduate?access_token=ACCESS_TOKEN

请求包体：

{
    "department_id":8542
}

返回示例：

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