获取部门列表

使用场景： 获取家校的部门列表，应用可缓存起来构建部门树，用于展示校区、学段、年级和班级列表。

权限说明

请求方式： GET（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/department/list

Query参数:

返回参数：

请求示例：

GET https://jz.hasmartedu.com/oapi/school/department/list?access_token=ACCESS_TOKEN&id=ID&department_type=DEPARTMENT_TYPE

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "departments": [
        {
            "id": 2,
            "type": 1,
            "name": "一年级5班",
            "parentid": 1,
            "register_year": 0,
            "standard_grade": 0,
            "custom_grade": 0,
            "order": 1,
            "department_admins": [
                {
                    "userid": "123",
                    "type": 4,
                    "subject": "数学",
                    "subject_code": "P002",
                    "source": 1,
                    "director_type" : 1
                }
            ],
            "code": "870543",
            "org_attribute": 3,
            "level": 5,
            "tag": 5
        }
    ]
}

获取部门详情

使用场景： 可以获取部门学生部门的详情，包括全路径。

权限说明

请求方式： GET HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/department/get

Query参数:

返回参数：

请求示例：

GET https://jz.hasmartedu.com/oapi/school/department/get?access_token=ACCESS_TOKEN&id=ID&is_full_path=IS_FULL_PATH

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "id": 97,
    "code": "870543",
    "name": "6",
    "type": 1,
    "parentid": 96,
    "register_year": 0,
    "standard_grade": 0,
    "custom_grade": 0,
    "org_attribute": 3,
    "order": 1,
    "tag": 5,
    "department_admins": [
        {
            "userid": "62",
            "type": 4,
            "subject": "数学",
            "subject_code": "P002",
            "source": 1,
            "director_type" : 1
        }
    ],
    "full_id_path": "/40/41/88/96/97",
    "full_path": "/实验中学/学生/一年级/2020级/6班"
}

批量查询部门详情

使用场景： 根据部门id列表，查询部门的详情

权限说明

请求方式： POST （HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/common/department/list?access_token=ACCESS_TOKEN

请求包体：

{
    "department":[5952576,5952579]
}

参数说明：

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "department": [
        {
            "department_id": 5952576,
            "name": "2015级",
            "level": 3,
            "parentid": 5165436,
            "tag": 4,
            "full_path": "/倩倩标准版十中/学生/2015级",
            "department_type": 1,
            "section": 3,
            "code": "1009697_1_352079",
            "standard_grade": 0,
            "register_year": 2015,
            "sort": 3,
            "full_id_path": "/5165435/5165436/5952576"
        },
        {
            "department_id": 5952579,
            "name": "3班",
            "level": 4,
            "parentid": 5952576,
            "tag": 5,
            "full_path": "/倩倩标准版十中/学生/2015级/3班",
            "department_type": 1,
            "section": 3,
            "code": "1009697_1_36741",
            "standard_grade": 0,
            "register_year": 0,
            "sort": 3,
            "full_id_path": "/5165435/5165436/5952576/5952579"
        }
    ]
}

返回值参数说明：

检索部门

使用场景： 学生部门检索，可以根据name, code,parentid三个任意一个来搜索学生部门，并且名称支持模糊检索，部门type限制为行政班，课程班，教学班之一。

权限说明

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/department/search

Query参数:

Body参数：

返回参数：

请求示例：

POST https://jz.hasmartedu.com/oapi/school/department/search?access_token=ACCESS_TOKEN

请求包体：

{
    "name": "一",
    "is_name_fuzzy": 1,
    "type": 1
}

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 2,
    "school_departments": [
        {
            "id": 5956,
            "name": "一年级"
        },
        {
            "id": 5957,
            "name": "一班"
        }
    ]
}

获取指定类型部门列表

使用场景： 根据部门类型分页获取部门列表，用于获取指定类型的部门进行展示。

权限说明

请求方式： [GET, POST]（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/department/list_by_tag

Query参数:

返回参数：

请求示例：

GET https://jz.hasmartedu.com/oapi/school/department/list_by_tag?access_token=ACCESS_TOKEN&page_index=PAGE_INDEX&page_size=PAGE_SIZE&tag=TAG

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "total": 3,
    "departments": [
        {
            "department_id": 6624,
            "name": "2020级",
            "level": 5,
            "parentid": 6623,
            "tag": 4,
            "full_path": "/实验中学/学生/大学城/高中部/2020级",
            "extra": "二年级",
            "code": "1081630",
            "standard_grade": 92,
            "custom_grade": 0,
            "register_year": 2020,
            "section": 3
        }
    ]
}

获取班级的学生数量

使用场景： 调用本接口，可以获取班级部门的学生数量。

权限说明

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/department/get_student_num

Query参数:

Body参数：

返回参数：

请求示例：

POST https://jz.hasmartedu.com/oapi/school/department/get_student_num?access_token=ACCESS_TOKEN

请求包体：

{
    "department_ids": [
        10001,
        10002
    ]
}

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "data_list": [
        {
            "department_id": 10001,
            "student_num": 30
        },
        {
            "department_id": 10002,
            "student_num": 10
        }
    ]
}