一、基本信息

---

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

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

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

请求方式：POST

请求类型：application/json

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

接口版本：3.0

修改日期：2023-12-05

二、请求参数

---

参数名	类型	是否必填	说明
appKey	String	是	平台提供的唯一标识
schoolID	String	是	学校ID，从学校列表获取

{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS=="
}

三、响应结果

---

响应参数名称	响应参数类型	是否有值	说明
studentInfos	Array	是	学生信息列表
studentEID	String	是	学生EID（默认使用登录名），可支持使用：1、平台ID，2、登录名，3、第三方厂商ID 三种方式切换
studentName	String	是	学生姓名
gender	String	是	性别："男"或"女"，null值表示未知
studentNo	String	是	学生学号
classNo	String	否	班级学号（座位号），null值，表示未填
examNo	String	否	学生考号，null值，表示未填
pic	String	否	暂时没有学生的照片信息
qualifiedClassID	String	是	全校唯一ID
teachingClassFullIDs	Array	否	教学班年级唯一标识ID
electiveClassFullIDs	Array	否	选修班班级ID
extraField1	String	否	备注1（学籍主号） 备注字段，默认为空
extraField2	String	否	备注2（学籍辅号） 备注字段，默认为空
extraField3	String	否	备注3（校内学号） 备注字段，默认为空
updateTime	String	是	更新时间（格式化UTC时间，比北京时间早8小时，UTC+时区差＝本地时间）

{
    "code": 0,
    "status": "success",
    "result": {
        "studentInfos": [
            {
                "loginName": "2025001",
                "studentEID": "2025001",
                "studentName": "亭宇",
                "gender": "男",
                "studentNo": "240641",
                "classNo": "01",
                "examNo": "001",
                "pic": null,
                "qualifiedClassID": "1012025-1",
                "teachingClassFullIDs": [
                    "1012022-7",
                    "1012022-15"
                ],
                "electiveClassFullIDs": [],
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-15T16:02:15Z"
            },
            {
                "loginName": "2025002",
                "studentEID": "2025002",
                "studentName": "子辰",
                "gender": "男",
                "studentNo": "240640",
                "classNo": null,
                "examNo": "002",
                "pic": null,
                "qualifiedClassID": "1012025-2",
                "teachingClassFullIDs": [
                    "1012021-50",
                    "1012021-75",
                    "1012021-27",
                    "1012021-87"
                ],
                "electiveClassFullIDs": [],
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-15T16:02:15Z"
            }
        ]
    }
}