Skip to main content

一、基本信息​

接口名称：获取全部行政班信息接口

接口说明：获取当前学校下所有行政班班级列表

请求地址：${BASEURL}/dataconnectorserv/integration/basic/getClasses

请求方式：POST

请求类型：application/json

接口频率：接口调用上限500次/天

接口版本：3.0

修改日期：2023-12-05

二、请求参数​

参数名类型是否必填说明
appKeyString是平台提供的唯一标识
schoolIDString是学校ID，从学校列表获取
{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS=="
}

三、响应结果​

响应参数名称响应参数类型是否有值说明
classesArray是班级列表
entranceYearString是入学年份
eduStageString是学校学段：幼儿园，小学，初中，高中，大学
gradeIDString是年级ID
gradeNameString是年级名称
classLabelsString否班级标签
classFullNameString是班级名称
locationIDString否班级教室ID，null值，表示课表行政班未安排教室
locationNameString否班级教室名称，null值，表示课表行政班未安排教室
qualifiedClassIDString是全校唯一ID
classTeacherListArray否班主任列表，null值，表示未填写班主任，存在历史字段classTeacher，区别拓展班级班主任存在多个
teacherEIDString否班主任-教师EID
teacherNameString否班主任-教师姓名
updateTimeString是更新时间（格式化UTC时间，比北京时间早8小时，UTC+时区差＝本地时间）
{
    "status": "success",
    "result": {
        "classes": [
            {
                "entranceYear": "2023",
                "eduStage": "初中",
                "gradeID": "2012023",
                "gradeName": "初一",
                "classLabels": [
                    "冲刺班"
                ],
                "classFullName": "初二1班",
                "locationID": "10",
                "locationName": "101教室",
                "qualifiedClassID": "2012023-1",
                "classTeacherList": [
                    {
                        "teacherEID": "13333332222",
                        "teacherName": "演示教师"
                    }
                ],
                "updateTime": "2023-01-11T07:30:40Z"
            },
            {
                "entranceYear": "2023",
                "eduStage": "高中",
                "gradeID": "1012023",
                "gradeName": "高一",
                "classLabels": [
                    "火箭班"
                ],
                "classFullName": "高一1班",
                "locationID": "12",
                "locationName": "高一1班",
                "qualifiedClassID": "1012021-2",
                "classTeacherList": [
                    {
                        "teacherEID": "13333332222",
                        "teacherName": "演示教师"
                    },
                    {
                        "teacherEID": "133333321111",
                        "teacherName": "演示教师2"
                    }
                ],
                "updateTime": "2023-01-11T07:30:41Z"
            },
            {
                "entranceYear": "2021",
                "eduStage": "高中",
                "gradeID": "1012021",
                "gradeName": "高一",
                "classLabels": [],
                "classFullName": "高一2班",
                "locationID": null,
                "locationName": null,
                "qualifiedClassID": "1012021-2",
                "classTeacherList": null,
                "updateTime": "2023-01-11T07:30:41Z"
            }
        ]
    }
}