学生数据

本接口数据来源教育教学管理系统，包含本科生、研究生学籍数据。

学生基本数据

描述

提供学生自然人基本数据。其中邮箱(email)、手机号码(mobilePhone)字段来源学工系统，其余字段来源本研一体系统。

根据最小化存储原则，涉及个人敏感数据请谨慎保存。建议您只保存业务中需要的数据字段。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/studentinfo

请求参数

参数名	是否必填	备注
ts	是	时间戳，获取该时间后更新的数据；ts=0获取全部数据
pageNum	是	分页第几页，从 1 开始
pageSize	是	每页的数量，每次请求小于等于2000

返回参数

参数名	类型	备注
bizType	string	业务类型（本科、研究生）
studentCode	string	学号（唯一）
studentName	string	证件姓名
department	string	院系
gender	string	性别
birthday	string	出生日期
political	string	政治面貌
country	string	国家地区
nation	string	民族
idCardType	string	证件类型
idCardNumber	string	证件号码
nativeChinaPlace	string	籍贯
schoolEmail	string	学校邮箱
mobilePhone	string	手机号码
email	string	邮箱
createdAt	datetime	记录创建时间
updatedAt	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/studentinfo?ts=0&pageNum=1&pageSize=10"

返回示例

json

{
    "data": {
        "totalNum": 42104,
        "pageSize": 10,
        "rows": [
            {
                "bizType": "本科",
                "studentCode": "10*******01",
                "studentName": "高**",
                "department": "哲**",
                "gender": "男",
                "birthday": "2000-02-23 00:00:00",
                "political": "共青团员",
                "country": "",
                "nation": "汉族",
                "idCardType": "居民身份证",
                "idCardNumber": "41**************95",
                "nativeChinaPlace": "",
                "schoolEmail": "10*******01@stu.ecnu.edu.cn",
                "email": "11*******@qq.com",
                "mobilePhone": "18*******01",
                "createdAt": "2026-03-06 16:46:40",
                "updatedAt": "2026-03-11 12:02:06"
            },
            {
                "bizType": "本科",
                "studentCode": "10*******09",
                "studentName": "李**",
                "department": "中国******",
                "gender": "男",
                "birthday": "2001-11-01 00:00:00",
                "political": "共青团员",
                "country": "",
                "nation": "彝族",
                "idCardType": "居民身份证",
                "idCardNumber": "51**************1X",
                "nativeChinaPlace": "",
                "schoolEmail": "10*******09@stu.ecnu.edu.cn",
                "email": "24*******@qq.com",
                "mobilePhone": "13*******57",
                "createdAt": "2026-03-06 16:46:41",
                "updatedAt": "2026-03-11 12:02:08"
            },
            {
                "bizType": "本科",
                "studentCode": "10*******32",
                "studentName": "周*",
                "department": "体育******",
                "gender": "男",
                "birthday": "2001-01-29 00:00:00",
                "political": "群众",
                "country": "",
                "nation": "汉族",
                "idCardType": "居民身份证",
                "idCardNumber": "34*************18",
                "nativeChinaPlace": "",
                "schoolEmail": "10*******32@stu.ecnu.edu.cn",
                "email": "10*******@qq.com",
                "mobilePhone": "18*******12",
                "createdAt": "2026-03-06 16:46:40",
                "updatedAt": "2026-03-11 12:02:07"
            }
            ......
        ],
        "pageNum": 1
    },
    "errCode": 0,
    "requestId": "2664d0c73c7dbcecd0752d57ad7a74e9",
    "errMsg": "success",
    "apiLog": ""
}

学生基本数据单条查询

描述

提供学生自然人基本数据单条数据查询。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/studentbasicinfo

请求参数

参数名	是否必填	备注
userId	是	学号

返回参数

参数名	类型	备注
bizType	string	业务类型（本科、研究生）
studentCode	string	学号（唯一）
studentName	string	证件姓名
department	string	院系
gender	string	性别
birthday	string	出生日期
political	string	政治面貌
country	string	国家地区
nation	string	民族
idCardType	string	证件类型
idCardNumber	string	证件号码
nativeChinaPlace	string	籍贯
schoolEmail	string	学校邮箱
mobilePhone	string	手机号码
email	string	邮箱
createdAt	datetime	记录创建时间
updatedAt	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/studentbasicinfo?userId=51*******01"

返回示例

json

{
    "data": [
        {
            "bizType": "研究生",
            "studentCode": "51*******34",
            "studentName": "侯**",
            "mngtDepartment": "音乐**",
            "department": "音乐**",
            "major": "音乐",
            "grade": "2023",
            "enterSchoolDate": "2023-09-10",
            "gender": "女",
            "birthday": "20**-0*-1*",
            "political": "群众",
            "country": "中国",
            "nation": "汉族",
            "idCardType": "居民身份证",
            "idCardNumber": "31**************40",
            "nativeChinaPlace": "上海市|**区|**区",
            "schoolEmail": "51*******34@stu.ecnu.edu.cn",
            "email": "18**********@163.com",
            "mobilePhone": "18**********10",
            "createdAt": "2026-03-06 16:46:57",
            "updatedAt": "2026-03-06 16:46:57"
        }
    ],
    "errCode": 0,
    "requestId": "a86b77965afc3f4fd64d67b6d69a9ddc",
    "errMsg": "success"
}

公共学籍管理数据

描述

该API提供学生（本、研）学籍全量字段，数据来源本研一体系统。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/studentstatus

请求参数

参数名	是否必填	备注
biz_type	否	业务类型（本科、研究生）
mngt_dept_code	否	管理院系代码
dept_code	否	专业所在院系代码
ts	是	时间戳，获取该时间后更新的数据；ts=0获取全部数据
pageNum	是	分页第几页，从 1 开始
pageSize	是	每页的数量，每次请求小于等于2000

返回参数

参数名	类型	备注
BIZ_TYPE	string	业务类型（本科、研究生）
GRADE	string	年级
STUDENT_CODE	string	学号（唯一）
STUDENT_NAME	string	证件姓名
STUDENT_NAME_PINYIN	string	姓名拼音（常用名/留学生有中文名，其他为证件姓名）
STUDENT_NAME_EN	string	英文姓名（证件姓名 - 留学生/姓名拼音 - 非留学生）
GENDER_CODE	string	性别代码
POLITICAL_CODE	string	政治面貌代码（
COUNTRY_CODE	string	国家地区代码
NATION_CODE	string	民族代码
ID_CARD_TYPE_CODE	string	证件类型代码
STUDY_YEARS	number	学制
MNGT_DEPARTMENT_CODE	string	管理院系代码（学籍所在院系：教育学部、孟院）
MNGT_DEPARTMENT	string	管理院系名称
DEPARTMENT_CODE	string	院系代码（学科专业所在院系）
DEPARTMENT	string	院系名称
MAJOR_CODE	string	学生专业代码
MAJOR	string	学生专业名称
MAJOR_DIRECTION_CODE	string	学生方向代码
MAJOR_DIRECTION	string	学生方向名称
IN_SCHOOL	string	是否在校
HAS_XUE_JI	string	是否有国家学籍（有：有学校学籍/无：无学校学籍）
ZAI_JI	string	是否在籍（有学校学籍，毕业、退学不在籍）
ENTER_SCHOOL_DATE	string	入学日期
EXPECTED_GRADUATE_DATE	string	预计毕业日期
GRADUATE_DATE	string	毕业日期
GRADUATE_RESULT	string	毕业结论
STD_STATUS	string	学籍状态
STD_TYPE_CODE	string	学生类别代码
STD_TYPE	string	学生类别名称
OVERSEAS_STUDENT	string	是否留学生
STD_FLAGS	string	学生标签（多个标签逗号隔开，本科提供）
EDUCATION_CODE	string	学历层次代码
EDUCATION	string	学历层次
CAMPUS	string	校区（引用 CAMPUS）
EXAMINEE_NO	string	考生号
DISCIPLINE_CATEGORY_CODE	string	学科门类代码
DISCIPLINE_CATEGORY	string	学科门类
FIRST_DISCIPLINE_CODE	string	一级学科/类别代码
FIRST_DISCIPLINE	string	一级学科/类别名称
SECOND_DISCIPLINE_CODE	string	二级学科/领域代码
SECOND_DISCIPLINE	string	二级学科/领域名称
created_at	datetime	记录创建时间
updated_at	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/studentstatus?mngt_dept_code=012903&pageNum=1&pageSize=10"

返回示例

json

{
    "data": {
        "totalNum": 42104,
        "pageSize": 5,
        "rows": [
            {
                "BIZ_TYPE": "本科",
                "GRADE": "2022",
                "STUDENT_CODE": "10******01",
                "STUDENT_NAME": "高**",
                "STUDENT_NAME_PINYIN": "Gao ******",
                "STUDENT_NAME_EN": "Gao ******",
                "GENDER_CODE": "1",
                "POLITICAL_CODE": "03",
                "COUNTRY_CODE": "",
                "NATION_CODE": "01",
                "ID_CARD_TYPE_CODE": "01",
                "STUDY_YEARS": 4,
                "MNGT_DEPARTMENT_CODE": "01****",
                "MNGT_DEPARTMENT": "哲**",
                "DEPARTMENT_CODE": "01****",
                "DEPARTMENT": "哲**",
                "MAJOR_CODE": "01**",
                "MAJOR": "哲**",
                "MAJOR_DIRECTION_CODE": "",
                "MAJOR_DIRECTION": "",
                "IN_SCHOOL": "是",
                "HAS_XUE_JI": "有",
                "ZAI_JI": "是",
                "ENTER_SCHOOL_DATE": "2018-09-01",
                "EXPECTED_GRADUATE_DATE": "2026-07-01",
                "GRADUATE_DATE": "",
                "GRADUATE_RESULT": "",
                "STD_STATUS": "正常",
                "STD_TYPE_CODE": "10",
                "STD_TYPE": "统招生",
                "OVERSEAS_STUDENT": "否",
                "STD_FLAGS": "大英测试必考学生",
                "EDUCATION_CODE": "01",
                "EDUCATION": "本科",
                "CAMPUS": "闵行校区",
                "EXAMINEE_NO": "18********97",
                "DISCIPLINE_CATEGORY_CODE": "",
                "DISCIPLINE_CATEGORY": "",
                "FIRST_DISCIPLINE_CODE": "",
                "FIRST_DISCIPLINE": "",
                "SECOND_DISCIPLINE_CODE": "",
                "SECOND_DISCIPLINE": "",
                "created_at": "2026-03-06 16:46:40",
                "updated_at": "2026-03-11 12:02:06"
            },
            {
                "BIZ_TYPE": "本科",
                "GRADE": "2022",
                "STUDENT_CODE": "10********9",
                "STUDENT_NAME": "李**",
                "STUDENT_NAME_PINYIN": "Li ******",
                "STUDENT_NAME_EN": "Li ******",
                "GENDER_CODE": "1",
                "POLITICAL_CODE": "03",
                "COUNTRY_CODE": "",
                "NATION_CODE": "07",
                "ID_CARD_TYPE_CODE": "01",
                "STUDY_YEARS": 4,
                "MNGT_DEPARTMENT_CODE": "01****",
                "MNGT_DEPARTMENT": "中国********",
                "DEPARTMENT_CODE": "01****",
                "DEPARTMENT": "中国********",
                "MAJOR_CODE": "01**",
                "MAJOR": "汉****",
                "MAJOR_DIRECTION_CODE": "011002",
                "MAJOR_DIRECTION": "普通专业",
                "IN_SCHOOL": "是",
                "HAS_XUE_JI": "有",
                "ZAI_JI": "是",
                "ENTER_SCHOOL_DATE": "2019-08-30",
                "EXPECTED_GRADUATE_DATE": "2026-07-01",
                "GRADUATE_DATE": "",
                "GRADUATE_RESULT": "",
                "STD_STATUS": "正常",
                "STD_TYPE_CODE": "10",
                "STD_TYPE": "统招生",
                "OVERSEAS_STUDENT": "否",
                "STD_FLAGS": "大英测试必考学生",
                "EDUCATION_CODE": "01",
                "EDUCATION": "本科",
                "CAMPUS": "闵行校区",
                "EXAMINEE_NO": "19*********17",
                "DISCIPLINE_CATEGORY_CODE": "",
                "DISCIPLINE_CATEGORY": "",
                "FIRST_DISCIPLINE_CODE": "",
                "FIRST_DISCIPLINE": "",
                "SECOND_DISCIPLINE_CODE": "",
                "SECOND_DISCIPLINE": "",
                "created_at": "2026-03-06 16:46:41",
                "updated_at": "2026-03-11 12:02:08"
            }
            ......
        ],
        "pageNum": 1
    },
    "errCode": 0,
    "requestId": "74bc5e34157cdd4f7961f2cc8b198211",
    "errMsg": "success",
    "apiLog": ""
}

公共学籍管理数据单条查询

描述

该API提供学生（本、研）学籍全量字段，数据来源本研一体系统。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/single/studentstatus

请求参数

参数名	是否必填	备注
student_code	是	学号

返回参数

参数名	类型	备注
BIZ_TYPE	string	业务类型（本科、研究生）
GRADE	string	年级
STUDENT_CODE	string	学号（唯一）
STUDENT_NAME	string	证件姓名
STUDENT_NAME_PINYIN	string	姓名拼音（常用名/留学生有中文名，其他为证件姓名）
STUDENT_NAME_EN	string	英文姓名（证件姓名 - 留学生/姓名拼音 - 非留学生）
GENDER_CODE	string	性别代码
POLITICAL_CODE	string	政治面貌代码（
COUNTRY_CODE	string	国家地区代码
NATION_CODE	string	民族代码
ID_CARD_TYPE_CODE	string	证件类型代码
STUDY_YEARS	number	学制
MNGT_DEPARTMENT_CODE	string	管理院系代码（学籍所在院系：教育学部、孟院）
MNGT_DEPARTMENT	string	管理院系名称
DEPARTMENT_CODE	string	院系代码（学科专业所在院系）
DEPARTMENT	string	院系名称
MAJOR_CODE	string	学生专业代码
MAJOR	string	学生专业名称
MAJOR_DIRECTION_CODE	string	学生方向代码
MAJOR_DIRECTION	string	学生方向名称
IN_SCHOOL	string	是否在校
HAS_XUE_JI	string	是否有国家学籍（有：有学校学籍/无：无学校学籍）
ZAI_JI	string	是否在籍（有学校学籍，毕业、退学不在籍）
ENTER_SCHOOL_DATE	string	入学日期
EXPECTED_GRADUATE_DATE	string	预计毕业日期
GRADUATE_DATE	string	毕业日期
GRADUATE_RESULT	string	毕业结论
STD_STATUS	string	学籍状态
STD_TYPE_CODE	string	学生类别代码
STD_TYPE	string	学生类别名称
OVERSEAS_STUDENT	string	是否留学生
STD_FLAGS	string	学生标签（多个标签逗号隔开，本科提供）
EDUCATION_CODE	string	学历层次代码
EDUCATION	string	学历层次
CAMPUS	string	校区（引用 CAMPUS）
EXAMINEE_NO	string	考生号
DISCIPLINE_CATEGORY_CODE	string	学科门类代码
DISCIPLINE_CATEGORY	string	学科门类
FIRST_DISCIPLINE_CODE	string	一级学科/类别代码
FIRST_DISCIPLINE	string	一级学科/类别名称
SECOND_DISCIPLINE_CODE	string	二级学科/领域代码
SECOND_DISCIPLINE	string	二级学科/领域名称
created_at	datetime	记录创建时间
updated_at	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/single/studentstatus?student_code=10*******02"

示例数据

json

{
    "data": [
        {
            "BIZ_TYPE": "本科",
            "GRADE": "2022",
            "STUDENT_CODE": "10*******02",
            "STUDENT_NAME": "胡**",
            "STUDENT_NAME_PINYIN": "Hu ****",
            "STUDENT_NAME_EN": "Hu ****",
            "GENDER_CODE": "2",
            "POLITICAL_CODE": "13",
            "COUNTRY_CODE": "156",
            "NATION_CODE": "01",
            "ID_CARD_TYPE_CODE": "01",
            "STUDY_YEARS": 4,
            "MNGT_DEPARTMENT_CODE": "01****",
            "MNGT_DEPARTMENT": "中国*****",
            "DEPARTMENT_CODE": "01****",
            "DEPARTMENT": "中国*****",
            "MAJOR_CODE": "01**",
            "MAJOR": "汉语***",
            "MAJOR_DIRECTION_CODE": "011002",
            "MAJOR_DIRECTION": "普通专业",
            "IN_SCHOOL": "是",
            "HAS_XUE_JI": "有",
            "ZAI_JI": "是",
            "ENTER_SCHOOL_DATE": "2021-08-01",
            "EXPECTED_GRADUATE_DATE": "2026-07-31",
            "GRADUATE_DATE": "",
            "GRADUATE_RESULT": "",
            "STD_STATUS": "正常",
            "STD_TYPE_CODE": "10",
            "STD_TYPE": "统招生",
            "OVERSEAS_STUDENT": "否",
            "STD_FLAGS": "大英测试必考学生",
            "EDUCATION_CODE": "01",
            "EDUCATION": "本科",
            "CAMPUS": "闵行校区",
            "EXAMINEE_NO": "21310112003820",
            "DISCIPLINE_CATEGORY_CODE": "",
            "DISCIPLINE_CATEGORY": "",
            "FIRST_DISCIPLINE_CODE": "",
            "FIRST_DISCIPLINE": "",
            "SECOND_DISCIPLINE_CODE": "",
            "SECOND_DISCIPLINE": "",
            "created_at": "2026-03-06 16:46:42",
            "updated_at": "2026-03-24 12:01:59"
        }
    ],
    "errCode": 0,
    "requestId": "d7fbdcc42b55fc115ce0e10465eae899",
    "errMsg": "success"
}

研究生学籍扩展数据

描述

该API提供研究生学籍扩展字段，数据来源本研一体系统。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/sudentstatus_pg

请求参数

参数名	是否必填	备注
mngt_dept_code	否	管理院系代码
dept_code	否	专业所在院系代码
study_form	否	学习形式（全日制、非全日制）
ts	是	时间戳，获取该时间后更新的数据；ts=0获取全部数据
pageNum	是	分页第几页，从 1 开始
pageSize	是	每页的数量，每次请求小于等于 2000

返回参数

参数名	类型	备注
STUDENT_CODE	string	学号（唯一）
STUDY_FORM	string	学习形式（全日制/非全日制）
DEGREE_CLASS	string	学位类型（学术学位/专业学位）
CULTIVATE_TYPE	string	培养类型（第一学位/第二学位）
CAN_SSO	string	是否允许统一认证
SSO_EXPIRATION_DATE	string	统一认证有效期
CAN_ECARD	string	是否允许校园卡
ECARD_EXPIRATION_DATE	string	校园卡有效期
RESEARCH_DIRECTION	string	研究方向
MAXIMUM_STUDY_YEARS	number	最长修读年限
SUPERVISOR_CODE	string	主导师工号
SUPERVISOR	string	主导师
SUPERVISOR_TITLE	string	主导师职称
CO_SUPERVISOR_CODES	string	导师组工号（多个逗号隔开）
CO_SUPERVISORS	string	导师组（多个逗号隔开）
WORK_COMPANY	string	工作单位
EXAM_METHOD_CODE	string	考试方式代码
EXAM_METHOD	string	考试方式
SPECIAL_PLAN_CODE	string	专项计划代码
SPECIAL_PLAN	string	专项计划
RECRUIT_CATEGORY_CODE	string	录取类别代码
RECRUIT_CATEGORY	string	录取类别
ENROLL_YEAR	string	录取年份
CERTIFICATE_CODE	string	毕业证书编号
DEGREE_CERT_CODE	string	学位证书编号
DIRECTED_CHINA_PLACE	string	定向就业单位所在地
DIRECTED_GRADUATE_INSTITUTION	string	定向就业单位
JOINT_CHINA_PLACE	string	联合培养单位所在地
JOINT_TRAINING_INSTITUTION	string	联合培养单位
UG_CHINA_SCHOOL	string	本科毕业单位
UG_MAJOR_CATALOG	string	本科毕业专业
UG_GRADUATE_DATE	string	本科毕业日期
UG_CERT_NUMBER	string	本科毕业证书编号
UG_STUDY_FORM	string	获得本科学历学习形式
BACHELOR_CHINA_SCHOOL	string	获学士学位单位
BACHELOR_MAJOR_CATALOG	string	获得学士学位专业
BACHELOR_GRADUATE_DATE	string	获得学士学位日期
BACHELOR_CERT_NUMBER	string	学士学位证书编号
PG_CHINA_SCHOOL	string	硕士毕业单位
PG_MAJOR_CATALOG	string	硕士毕业专业
PG_GRADUATE_DATE	string	硕士毕业日期
PG_CERT_NUMBER	string	硕士毕业证书编号
PG_STUDY_FORM	string	获得硕士学历学习形式
MASTER_CHINA_SCHOOL	string	获硕士学位单位
MASTER_MAJOR_CATALOG	string	获得硕士学位专业
MASTER_GRADUATE_DATE	string	获得硕士学位日期
MASTER_CERT_NUMBER	string	硕士学位证书编号
created_at	datetime	记录创建时间
updated_at	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/sudentstatus_pg?study_form=全日制&pageNum=1&pageSize=10"

返回示例

json

{
    "data": {
        "totalNum": 23033,
        "pageSize": 10,
        "rows": [
            {
                "STUDENT_CODE": "50******9",
                "STUDY_FORM": "全日制",
                "DEGREE_CLASS": "学术学位",
                "CULTIVATE_TYPE": "第一学位",
                "CAN_SSO": "是",
                "SSO_EXPIRATION_DATE": "",
                "CAN_ECARD": "是",
                "ECARD_EXPIRATION_DATE": "",
                "RESEARCH_DIRECTION": "",
                "OVERSEAS_STUDENT": "否",
                "MAXIMUM_STUDY_YEARS": 5,
                "SUPERVISOR_CODE": "",
                "SUPERVISOR": "",
                "SUPERVISOR_TITLE": "",
                "CO_SUPERVISOR_CODES": "",
                "CO_SUPERVISORS": "",
                "WORK_COMPANY": "**大学",
                "EXAM_METHOD_CODE": "",
                "EXAM_METHOD": "",
                "SPECIAL_PLAN_CODE": "605",
                "SPECIAL_PLAN": "非学籍_交流生_联合培养",
                "RECRUIT_CATEGORY_CODE": "",
                "RECRUIT_CATEGORY": "",
                "ENROLL_YEAR": "",
                "CERTIFICATE_CODE": "",
                "DEGREE_CERT_CODE": "",
                "DIRECTED_CHINA_PLACE": "",
                "DIRECTED_GRADUATE_INSTITUTION": "",
                "JOINT_CHINA_PLACE": "",
                "JOINT_TRAINING_INSTITUTION": "",
                "UG_CHINA_SCHOOL": "",
                "UG_MAJOR_CATALOG": "",
                "UG_GRADUATE_DATE": "",
                "UG_CERT_NUMBER": "",
                "UG_STUDY_FORM": "",
                "BACHELOR_CHINA_SCHOOL": "",
                "BACHELOR_MAJOR_CATALOG": "",
                "BACHELOR_GRADUATE_DATE": "",
                "BACHELOR_CERT_NUMBER": "",
                "PG_CHINA_SCHOOL": "",
                "PG_MAJOR_CATALOG": "",
                "PG_GRADUATE_DATE": "",
                "PG_CERT_NUMBER": "",
                "PG_STUDY_FORM": "",
                "MASTER_CHINA_SCHOOL": "",
                "MASTER_MAJOR_CATALOG": "",
                "MASTER_GRADUATE_DATE": "",
                "MASTER_CERT_NUMBER": "",
                "created_at": "2026-03-02 13:22:37",
                "updated_at": "2026-03-03 08:02:19"
            },
            {
                "STUDENT_CODE": "50********8",
                "STUDY_FORM": "全日制",
                "DEGREE_CLASS": "学术学位",
                "CULTIVATE_TYPE": "第一学位",
                "CAN_SSO": "是",
                "SSO_EXPIRATION_DATE": "",
                "CAN_ECARD": "是",
                "ECARD_EXPIRATION_DATE": "",
                "RESEARCH_DIRECTION": "",
                "OVERSEAS_STUDENT": "否",
                "MAXIMUM_STUDY_YEARS": 1,
                "SUPERVISOR_CODE": "",
                "SUPERVISOR": "",
                "SUPERVISOR_TITLE": "",
                "CO_SUPERVISOR_CODES": "",
                "CO_SUPERVISORS": "",
                "WORK_COMPANY": "**大学",
                "EXAM_METHOD_CODE": "",
                "EXAM_METHOD": "",
                "SPECIAL_PLAN_CODE": "605",
                "SPECIAL_PLAN": "非学籍_交流生_联合培养",
                "RECRUIT_CATEGORY_CODE": "",
                "RECRUIT_CATEGORY": "",
                "ENROLL_YEAR": "",
                "CERTIFICATE_CODE": "",
                "DEGREE_CERT_CODE": "",
                "DIRECTED_CHINA_PLACE": "",
                "DIRECTED_GRADUATE_INSTITUTION": "",
                "JOINT_CHINA_PLACE": "",
                "JOINT_TRAINING_INSTITUTION": "",
                "UG_CHINA_SCHOOL": "",
                "UG_MAJOR_CATALOG": "",
                "UG_GRADUATE_DATE": "",
                "UG_CERT_NUMBER": "",
                "UG_STUDY_FORM": "",
                "BACHELOR_CHINA_SCHOOL": "",
                "BACHELOR_MAJOR_CATALOG": "",
                "BACHELOR_GRADUATE_DATE": "",
                "BACHELOR_CERT_NUMBER": "",
                "PG_CHINA_SCHOOL": "",
                "PG_MAJOR_CATALOG": "",
                "PG_GRADUATE_DATE": "",
                "PG_CERT_NUMBER": "",
                "PG_STUDY_FORM": "",
                "MASTER_CHINA_SCHOOL": "",
                "MASTER_MAJOR_CATALOG": "",
                "MASTER_GRADUATE_DATE": "",
                "MASTER_CERT_NUMBER": "",
                "created_at": "2026-03-02 13:22:37",
                "updated_at": "2026-03-02 13:22:37"
            },
            ......
        ],
        "pageNum": 1
    },
    "errCode": 0,
    "requestId": "d200c59520f5fb8d9562fd750fd2188d",
    "errMsg": "success",
    "apiLog": ""
}

本科学籍扩展数据

描述

该API提供本科生学籍扩展字段，数据来源本研一体系统。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/studentstatus_ug

请求参数

参数名	是否必填	备注
mngt_dept_code	否	管理院系代码
dept_code	否	专业所在院系代码
ts	是	时间戳，获取该时间后更新的数据；ts=0获取全部数据
pageNum	是	分页第几页，从 1 开始
pageSize	是	每页的数量，每次请求小于等于 2000

返回参数

参数名	类型	备注
STUDENT_CODE	string	学号
CULTIVATE_TYPE	string	培养类型（主修/辅修/微专业）
ENTER_SCHOOL_GRADE	string	录取年份
SFMS	string	是否免费师范生码
NORMAL	string	是否师范生
created_at	datetime	记录创建时间
updated_at	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/studentstatus_ug?pageNum=1&pageSize=10"

返回示例

json

{
    "data": {
        "totalNum": 19068,
        "pageSize": 10,
        "rows": [
            {
                "STUDENT_CODE": "10********01",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "否",
                "NORMAL": "否",
                "created_at": "2026-03-19 15:47:19",
                "updated_at": "2026-03-19 15:47:19"
            },
            {
                "STUDENT_CODE": "10********09",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "否",
                "NORMAL": "否",
                "created_at": "2026-03-19 15:47:20",
                "updated_at": "2026-03-19 15:47:20"
            },
            {
                "STUDENT_CODE": "10********32",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "否",
                "NORMAL": "是",
                "created_at": "2026-03-19 15:47:19",
                "updated_at": "2026-03-19 15:47:19"
            },
            {
                "STUDENT_CODE": "10********61",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "否",
                "NORMAL": "否",
                "created_at": "2026-03-19 15:47:19",
                "updated_at": "2026-03-19 15:47:19"
            },
            {
                "STUDENT_CODE": "10********11",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "否",
                "NORMAL": "否",
                "created_at": "2026-03-19 15:47:20",
                "updated_at": "2026-03-19 15:47:20"
            },
            {
                "STUDENT_CODE": "10********21",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "是",
                "NORMAL": "是",
                "created_at": "2026-03-19 15:47:19",
                "updated_at": "2026-03-19 15:47:19"
            },
            {
                "STUDENT_CODE": "10********29",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "是",
                "NORMAL": "是",
                "created_at": "2026-03-19 15:47:19",
                "updated_at": "2026-03-19 15:47:19"
            },
            {
                "STUDENT_CODE": "10********33",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "是",
                "NORMAL": "是",
                "created_at": "2026-03-19 15:47:19",
                "updated_at": "2026-03-19 15:47:19"
            },
            {
                "STUDENT_CODE": "10********09",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "是",
                "NORMAL": "是",
                "created_at": "2026-03-19 15:47:20",
                "updated_at": "2026-03-19 15:47:20"
            },
            {
                "STUDENT_CODE": "10********30",
                "CULTIVATE_TYPE": "主修",
                "ENTER_SCHOOL_GRADE": "",
                "SFMS": "是",
                "NORMAL": "是",
                "created_at": "2026-03-19 15:47:20",
                "updated_at": "2026-03-19 15:47:20"
            }
        ],
        "pageNum": 1
    },
    "errCode": 0,
    "requestId": "bcb5d647f1019305bf8ab1216e5c5691",
    "errMsg": "success"
}

学生导师数据

描述

查询学生导师数据。可以按学号查询导师、导师组情况；可按导师工号查询该导师下所有学生；可查询全校导师学生关系。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/supervisor

请求参数

参数名	是否必填	备注
student_code	否	学号
supervisor_code	否	导师工号
ts	是	时间戳，获取该时间后更新的数据；ts=0获取全部数据
pageNum	是	分页第几页，从 1 开始
pageSize	是	每页的数量，每次请求小于等于 2000

说明：请求参数中携带student_code，supervisor_code时，则按学号、导师工号查询；如未携带这两个参数时，则查询全校导师学生关系。

返回参数

参数名	类型	备注
STUDENT_SUPERVISOR_ID	string	唯一标识
STUDENT_CODE	string	学号
SUPERVISOR_TYPE	string	导师类型（主导师/导师组）
SUPERVISOR_CODE	string	导师工号
SUPERVISOR	string	导师姓名
SUPERVISOR_TITLE	string	导师职称
created_at	datetime	记录创建时间
updated_at	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/supervisor?supervisor_code=20****19&pageNum=1&pageSize=10"

返回示例

json

{
    "data": {
        "totalNum": 62,
        "pageSize": 10,
        "rows": [
            {
                "STUDENT_SUPERVISOR_ID": "1009059218672975",
                "STUDENT_CODE": "51*******4",
                "SUPERVISOR_TYPE": "主导师",
                "SUPERVISOR_CODE": "20*****0",
                "SUPERVISOR": "赵**",
                "SUPERVISOR_TITLE": "副研究员",
                "created_at": "2026-03-19 00:11:22",
                "updated_at": "2026-03-19 00:11:22"
            },
            {
                "STUDENT_SUPERVISOR_ID": "1009082218672975",
                "STUDENT_CODE": "51*******8",
                "SUPERVISOR_TYPE": "主导师",
                "SUPERVISOR_CODE": "20*****0",
                "SUPERVISOR": "赵**",
                "SUPERVISOR_TITLE": "副研究员",
                "created_at": "2026-03-19 00:11:22",
                "updated_at": "2026-03-19 00:11:22"
            },
            {
                "STUDENT_SUPERVISOR_ID": "1009123218672975",
                "STUDENT_CODE": "51*******9",
                "SUPERVISOR_TYPE": "主导师",
                "SUPERVISOR_CODE": "20*****0",
                "SUPERVISOR": "赵**",
                "SUPERVISOR_TITLE": "副研究员",
                "created_at": "2026-03-19 00:11:22",
                "updated_at": "2026-03-19 00:11:22"
            },
            ......
        ],
        "pageNum": 1
    },
    "errCode": 0,
    "requestId": "60aa6b65765c09c9feedc7f7c13568e0",
    "errMsg": "success",
    "apiLog": ""
}

学籍异动

描述

查询学生学籍异动数据。

支持的模式

client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/alteration

请求参数

参数名	是否必填	备注
student_code	否	学号
ts	是	时间戳，获取该时间后更新的数据；ts=0获取全部数据
pageNum	是	分页第几页，从 1 开始
pageSize	是	每页的数量，每次请求小于等于 2000

返回参数

参数名	类型	备注
STD_ALTERATION_ID	number	唯一标识
STUDENT_CODE	string	学号
STUDENT_NAME	string	学生姓名
STD_ALTER_PROPERTY	string	异动性质
STD_ALTER_TYPE	string	异动类型
EFFECTIVE_DATE_TIME	string	异动生效时间
CREATE_DATE_TIME	string	异动审核时间
DOCUMENT_NUMBER	string	处理文号
created_at	datetime	记录创建时间
updated_at	datetime	记录更新时间

请求示例

bash

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/alteration?student_code=51*******8&pageNum=1&pageSize=10"

返回示例

json

{
    "data": {
        "totalNum": 99095,
        "pageSize": 10,
        "rows": [
            {
                "STD_ALTERATION_ID": 3,
                "STUDENT_CODE": "10*******22",
                "STUDENT_NAME": "郭**",
                "STD_ALTER_PROPERTY": "保留入学资格",
                "STD_ALTER_TYPE": "保留入学资格",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-08",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:54",
                "updated_at": "2026-03-19 15:48:54"
            },
            {
                "STD_ALTERATION_ID": 33,
                "STUDENT_CODE": "10*******12",
                "STUDENT_NAME": "陆**",
                "STD_ALTER_PROPERTY": "肄业",
                "STD_ALTER_TYPE": "肄业",
                "EFFECTIVE_DATE_TIME": "2011-07-01",
                "CREATE_DATE_TIME": "2012-11-16",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:48",
                "updated_at": "2026-03-19 15:48:48"
            },
            {
                "STD_ALTERATION_ID": 34,
                "STUDENT_CODE": "10*******06",
                "STUDENT_NAME": "胡**",
                "STD_ALTER_PROPERTY": "其它",
                "STD_ALTER_TYPE": "毕业",
                "EFFECTIVE_DATE_TIME": "2011-07-01",
                "CREATE_DATE_TIME": "2012-11-16",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:48",
                "updated_at": "2026-03-19 15:48:48"
            },
            {
                "STD_ALTERATION_ID": 65,
                "STUDENT_CODE": "10*******10",
                "STUDENT_NAME": "罗**",
                "STD_ALTER_PROPERTY": "肄业",
                "STD_ALTER_TYPE": "肄业",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-19",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:49",
                "updated_at": "2026-03-19 15:48:49"
            },
            {
                "STD_ALTERATION_ID": 67,
                "STUDENT_CODE": "10*******54",
                "STUDENT_NAME": "金**",
                "STD_ALTER_PROPERTY": "复学",
                "STD_ALTER_TYPE": "复学",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-19",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:47",
                "updated_at": "2026-03-19 15:48:47"
            },
            {
                "STD_ALTERATION_ID": 68,
                "STUDENT_CODE": "10*******02",
                "STUDENT_NAME": "金**",
                "STD_ALTER_PROPERTY": "休学",
                "STD_ALTER_TYPE": "休学",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-19",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:50",
                "updated_at": "2026-03-19 15:48:50"
            },
            {
                "STD_ALTERATION_ID": 69,
                "STUDENT_CODE": "10*******05",
                "STUDENT_NAME": "干**",
                "STD_ALTER_PROPERTY": "休学",
                "STD_ALTER_TYPE": "休学",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-19",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:54",
                "updated_at": "2026-03-19 15:48:54"
            },
            {
                "STD_ALTERATION_ID": 70,
                "STUDENT_CODE": "20*******16",
                "STUDENT_NAME": "沈**",
                "STD_ALTER_PROPERTY": "休学",
                "STD_ALTER_TYPE": "休学",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-19",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:48",
                "updated_at": "2026-03-19 15:48:48"
            },
            {
                "STD_ALTERATION_ID": 71,
                "STUDENT_CODE": "10*******08",
                "STUDENT_NAME": "孔**",
                "STD_ALTER_PROPERTY": "休学",
                "STD_ALTER_TYPE": "休学",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-19",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:50",
                "updated_at": "2026-03-19 15:48:50"
            },
            {
                "STD_ALTERATION_ID": 72,
                "STUDENT_CODE": "10*******30",
                "STUDENT_NAME": "金**",
                "STD_ALTER_PROPERTY": "休学",
                "STD_ALTER_TYPE": "休学",
                "EFFECTIVE_DATE_TIME": "2012-09-01",
                "CREATE_DATE_TIME": "2012-11-19",
                "DOCUMENT_NUMBER": "20**********",
                "created_at": "2026-03-19 15:48:47",
                "updated_at": "2026-03-19 15:48:47"
            }
        ],
        "pageNum": 1
    },
    "errCode": 0,
    "requestId": "6b19c1e3f17fc71a3cac9f1c7bbc8fbd",
    "errMsg": "success"
}

学生数据 ​

学生基本数据 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

返回示例 ​

学生基本数据单条查询 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

返回示例 ​

公共学籍管理数据 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

返回示例 ​

公共学籍管理数据单条查询 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

示例数据 ​

研究生学籍扩展数据 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

返回示例 ​

本科学籍扩展数据 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

返回示例 ​

学生导师数据 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

返回示例 ​

学籍异动 ​

描述 ​

支持的模式 ​

请求方法 ​

请求地址 ​

请求参数 ​

返回参数 ​

请求示例 ​

返回示例 ​

学生数据

学生基本数据

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

返回示例

学生基本数据单条查询

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

返回示例

公共学籍管理数据

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

返回示例

公共学籍管理数据单条查询

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

示例数据

研究生学籍扩展数据

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

返回示例

本科学籍扩展数据

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

返回示例

学生导师数据

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

返回示例

学籍异动

描述

支持的模式

请求方法

请求地址

请求参数

返回参数

请求示例

返回示例