🎉 开放平台文档站换新颜。 欢迎填问卷给我们建议，意见，反馈，夸夸 →
Skip to Content
API文档学生数据学生基础数据学生基本信息

学生基本信息

最近更新时间: 2026年06月30日 06时38分51秒
数据中心
批量
多源整合

描述

单条或批量获取学生基本信息。

支持的模式

客户端模式,授权码模式

请求方法

GET

请求地址

数据来源

SYS20230001(同济大学教学管理信息系统),SYS20240350(统一身份认证),SYS20230028(学生信息管理系统)

请求参数

参数名是否必填备注
userId否学工号
sinceTime否日期
statusCode否人员身份认证状态，0代表有效、1代表失效、-1代表全部 不传参数默认为0
deptCode否部门/学院代码 不传代表全部获取
secondDeptCode否培养专业 不传代表全部获取
leaveSchoolCode否在校状态,针对研究生 不传代表全部获取
isMembershipCode否是否在籍,针对本科生,1-是，0-否 不传代表全部获取
registrationStatusCode否学籍状态，针对本科生 不传代表全部获取
userTypeCode否人员类型代码 2-本科生、3-硕士研究生、4-博士研究生 不传代表全部获取
trainingCategoryCode否培养类别代码 不传代表全部获取
currentGrade否当前年级 不传代表全部获取
sinceUserId否游标的起始位置，请把响应中的同字段传入，获取下一页，循环往复获取全量数据
sinceUpdateTime否更新时间，获取该时间点之后信息有更改的数据，此字段格式支持YYYY-MM-DD HH:mm:ss 和 unix时间戳

返回参数

参数名类型备注码表
userId
string学工号
name
string姓名
sexCode
string性别
sexName
string性别名称
deptCode
string部门/学院代码
deptName
string部门/学院名称
secondDeptCode
string培养专业
secondDeptName
string培养专业名称
schoolCode
string学堂id
schoolName
string学堂名称
politicalStatusCode
string政治面貌
来源：学工系统
politicalStatusName
string政治面貌名称
campusCode
string校区
campusName
string校区名称
currentGrade
string当前年级
trainingLevelCode
string培养层次
trainingLevelName
string培养层次名称
leaveSchoolCode
string在校状态,针对研究生
leaveSchoolName
string在校状态名,针对研究生称
isMembershipCode
string是否在籍,针对本科生,1-是，0-否
isMembershipName
string是否在籍名称,针对本科生,
expGraduationDate
string预计毕业时间
enrolDate
TIMESTAMP入学时间
offSchool
string离校时间
teacherId
string导师工号
viceTeacherId
string副导师工号
isIncumbencyCode
string是否在职，针对研究生，本科生此字段为空，1-是，0-否
isIncumbencyName
string是否在职名称，针对研究生，本科生此字段为空
userTypeCode
string人员类型代码
userTypeName
string人员类型名称
registrationStatusCode
string学籍状态，针对本科生
registrationStatusName
string学籍状态名称，针对本科生
statusCode
string人员身份认证状态，0代表有效、1代表失效
statusName
string人员身份认证状态名称
trainingCategoryCode
string培养类别
trainingCategoryName
string培养类别名称
lengthSchooling
string学制
isOverseasCode
string是否留学生
isOverseasName
string是否留学生名称
updateTime
date更新时间
managementCollege2Code
string管理学院2
managementCollege2Name
string管理学院2名称
studyForm
string学习形式
studyFormName
string学习形式名称

解释说明

此接口可入参学号单条获取学生基本信息。如需不传参批量获取数据，请看以下说明： 初始化获取全量数据： 首次请求无需传参，每次固定返回1000条数据，获取后续数据在请求上附上上一次的sinceUserId，当sinceUserId为空或者返回条数为0时,可以停止循环，已经获取全量数据。 获取增量数据：入参为sinceUpdateTime，获取该时间点之后有更改的数据。

请求示例

curl -X GET \
  'https://api.tongji.edu.cn/v2/dc/user/student_infos?userId=&sinceTime=&statusCode=&deptCode=&secondDeptCode=&leaveSchoolCode=&isMembershipCode=&registrationStatusCode=&userTypeCode=&trainingCategoryCode=&currentGrade=&sinceUserId=&sinceUpdateTime='

返回示例

{
  "code": "A00000",
  "data": {
    "count": 27,
    "sinceUserId": "2******4",
    "list": [
      {
        "campusCode": " ",
        "campusName": null,
        "createTime": "20**-08-09 00:00:00",
        "currentGrade": 2022,
        "deptCode": "0****7",
        "deptName": "**院",
        "expGraduationDate": "0001-01-01 00:00:00",
        "isIncumbencyCode": " ",
        "isIncumbencyName": null,
        "isMembershipCode": "1",
        "isMembershipName": "是",
        "leaveSchoolCode": "1",
        "leaveSchoolName": "校内在读",
        "isOverseasCode": "0",
        "isOverseasName": "否",
        "name": "**悦",
        "offSchool": " ",
        "politicalStatusCode": "13",
        "politicalStatusName": "群众",
        "registrationStatusCode": "20",
        "registrationStatusName": "在校",
        "schoolCode": "54",
        "schoolName": "济美",
        "secondDeptCode": "***4",
        "secondDeptName": "***类",
        "sexCode": "2",
        "sexName": "女",
        "statusCode": "0",
        "statusName": "有效",
        "teacherId": "1****7",
        "trainingCategoryCode": "3",
        "trainingCategoryName": "学历学位生",
        "trainingLevelCode": "1",
        "trainingLevelName": "本科",
        "updateTime": "2022-12-07 00:00:00",
        "userId": "2******4",
        "userTypeCode": "2",
        "userTypeName": "本科生",
        "viceTeacherId": " ",
        "enrolDate": " ",
        "lengthSchooling": "4"
      },
      {
        "campusCode": " ",
        "campusName": null,
        "createTime": "2022-08-06 00:00:00",
        "currentGrade": 2022,
        "deptCode": "0*****7",
        "deptName": "**院",
        "expGraduationDate": "0001-01-01 00:00:00",
        "isIncumbencyCode": " ",
        "isIncumbencyName": null,
        "isMembershipCode": "1",
        "isMembershipName": "是",
        "leaveSchoolCode": "1",
        "leaveSchoolName": "校内在读",
        "isOverseasCode": "0",
        "isOverseasName": "否",
        "name": "**轩",
        "offSchool": " ",
        "politicalStatusCode": "13",
        "politicalStatusName": "群众",
        "registrationStatusCode": "20",
        "registrationStatusName": "在校",
        "schoolCode": "54",
        "schoolName": "济美",
        "secondDeptCode": "3****7",
        "secondDeptName": "工******",
        "sexCode": "1",
        "sexName": "男",
        "statusCode": "0",
        "statusName": "有效",
        "teacherId": "0****5",
        "trainingCategoryCode": "3",
        "trainingCategoryName": "学历学位生",
        "trainingLevelCode": "1",
        "trainingLevelName": "本科",
        "updateTime": "2022-12-07 00:00:00",
        "userId": "2******2",
        "userTypeCode": "2",
        "userTypeName": "本科生",
        "viceTeacherId": " ",
        "enrolDate": " ",
        "lengthSchooling": "4"
      }
    ]
  },
  "msg": "成功"
}
同济邮箱信息学生基本信息-实时