Skip to main content

一、基本信息​

接口名称：获取学生班级对应关系接口

接口说明：获取学校全部学生列表与班级的对应关系，包含行政班与教学班。

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

请求方式：POST

请求类型：application/json

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

接口版本：3.0

修改日期：2023-12-05

二、请求参数​

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

三、响应结果​

响应参数名称响应参数类型是否有值说明
studentClassesArray是学生班级信息列表
studentEIDString是学生EID（默认使用登录名），可支持使用：1、平台ID，2、登录名，3、第三方厂商ID 三种方式切换
studentNameString是学生姓名
qualifiedClassIDString是全校唯一ID
studentNoString是学生学号
classNoString否班级学号（座位号），null值，表示未填
examNoString否学生考号
teachingClassFullNamesArray否教学班班级名称
electiveClassFullNamesArray否选修班班级名称
extraField1String否备注1（学籍主号） 备注字段，默认为空
extraField2String否备注2（学籍辅号） 备注字段，默认为空
extraField3String否备注3（校内学号） 备注字段，默认为空
updateTimeString是更新时间（格式化UTC时间，比北京时间早8小时，UTC+时区差＝本地时间）
{
    "code": 0,
    "status": "success",
    "result": {
        "studentClasses": [
            {
                "studentEID": "5132022039",
                "studentName": "吕诸林",
                "qualifiedClassID": "1012022-5",
                "studentNo": "240641",
                "classNo": "01",
                "examNo": "202601",
                "teachingClassFullNames": [
                    "高二地理2班",
                    "高二化学3班",
                    "高二政治5班"
                ],
                "electiveClassFullNames": [],
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-16T16:02:17Z"
            },
            {
                "studentEID": "5132022038",
                "studentName": "吕文杰",
                "qualifiedClassID": "1012022-4",
                "studentNo": "240641",
                "classNo": null,
                "examNo": null,
                "teachingClassFullNames": [
                    "高二生物1班",
                    "高二政治3班"
                ],
                "electiveClassFullNames": [],
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-16T16:02:17Z"
            }
        ]
    }
}