Skip to main content

一、基本信息​

接口名称：获取学校学生列表接口

接口说明：获取学校所有学生数据，可使用参考学生详细信息接口（学生班级对应关系接口 + 学生信息接口）

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

请求方式：POST

请求类型：application/json

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

接口版本：3.0

修改日期：2023-12-05

二、请求参数​

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

三、响应结果​

响应参数名称响应参数类型是否有值说明
studentsArray是学生列表
loginNameString是登录名（学校学号/学籍号/身份证号）唯一
studentEIDString是学生EID（默认使用登录名），可支持使用：1、平台ID，2、登录名，3、第三方厂商ID 三种方式切换
studentNameString是学生姓名
genderString是"男"或"女"，null值，表示未知
studentNoString是学生学号
classNoString否班级学号（座位号），null值，表示未填
examNoString否学生考号，null值，表示未填
picString是BASE64编码JPEG图片，缺字段或null值表示未提供照片(暂无)
extraField1String否备注1（学籍主号） 备注字段，默认为空
extraField2String否备注2（学籍辅号） 备注字段，默认为空
extraField3String否备注3（校内学号） 备注字段，默认为空
updateTimeString是更新时间（格式化UTC时间，比北京时间早8小时，UTC+时区差＝本地时间）
{
    "code": 0,
    "status": "success",
    "result": {
        "students": [
            {
                "loginName": "5132022039",
                "studentEID": "5132022039",
                "studentName": "吕诸林",
                "gender": "男",
                "studentNo": "240641",
                "classNo": "01",
                "examNo": "001",
                "pic": null,
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-15T16:02:15Z"
            },
            {
                "loginName": "5132022058",
                "studentEID": "5132022058",
                "studentName": "李妤佳",
                "gender": "女",
                "studentNo": "210321",
                "classNo": "02",
                "examNo": "002",
                "pic": null,
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2023-10-15T16:02:15Z"
            },
            {
                "loginName": "210321",
                "studentEID": "3849570",
                "studentName": "邓卓峻",
                "gender": "男",
                "studentNo": "210321",
                "classNo": null,
                "examNo": null,
                "pic": null,
                "extraField1": "",
                "extraField2": "",
                "extraField3": "",
                "updateTime": "2025-09-24T06:57:14Z"
            }
        ]
    }
}