Skip to main content

一、基本信息​

接口名称：获取学生详细信息接口

接口说明：获取学生详细信息接口，合并两个接口（学生班级对应关系接口 + 学生信息接口）

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

请求方式：POST

请求类型：application/json

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

接口版本：3.0

修改日期：2023-12-05

二、请求参数​

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

三、响应结果​

响应参数名称响应参数类型是否有值说明
studentInfosArray是学生信息列表
studentEIDString是学生EID，EID可切换1.平台ID，2.登录名，3.第三方厂商ID
studentNameString是学生姓名
genderString是性别："男"或"女"，null值表示未知
picString否暂时没有学生的照片信息
qualifiedClassIDString是全校唯一ID
teachingClassFullIDsArray否教学班年级唯一标识ID
electiveClassFullIDsArray否选修班班级ID
extraField1String否备注1（学籍主号） 备注字段，默认为空
extraField2String否备注2（学籍辅号） 备注字段，默认为空
extraField3String否备注3（校内学号） 备注字段，默认为空
updateTimeString是更新时间（格式化UTC时间，比北京时间早8小时，UTC+时区差＝本地时间）
{
    "code": 0,
    "status": "success",
    "result": {
        "studentInfos": [
            {
                "studentEID": "5132022038",
                "studentName": "吕文杰",
                "gender": "女",
                "pic": null,
                "qualifiedClassID": "1012022-4",
                "teachingClassFullIDs": [
                    "1012022-7",
                    "1012022-15"
                ],
                "electiveClassFullIDs": [],
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-15T16:02:15Z"
            },
            {
                "studentEID": "5282021090",
                "studentName": "汪嘉贵",
                "gender": "男",
                "pic": null,
                "qualifiedClassID": "1012021-2",
                "teachingClassFullIDs": [
                    "1012021-50",
                    "1012021-75",
                    "1012021-27",
                    "1012021-87"
                ],
                "electiveClassFullIDs": [],
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-15T16:02:15Z"
            }
        ]
    }
}