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

学生基本信息

最近更新时间: 2025年05月08日 02时17分13秒
数据中心
批量

描述

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

支持的模式

客户端模式

请求方法

GET

请求地址

https://api.tongji.edu.cn/v2/dc/user/student_infos 

数据来源

教务系统,人员状态系统,学工系统

请求参数

参数名是否必填备注
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时间戳

返回参数

参数名类型备注码表
userIdstring学工号
namestring姓名
sexCodestring性别
sexNamestring性别名称
deptCodestring部门/学院代码
deptNamestring部门/学院名称
secondDeptCodestring培养专业second_dept_code
secondDeptNamestring培养专业名称
schoolCodestring学堂id
schoolNamestring学堂名称
politicalStatusCodestring政治面貌
politicalStatusNamestring政治面貌名称
campusCodestring校区
campusNamestring校区名称
currentGradestring当前年级
trainingLevelCodestring培养层次training_level_code
trainingLevelNamestring培养层次名称
leaveSchoolCodestring在校状态,针对研究生leave_school_code
leaveSchoolNamestring在校状态名,针对研究生称
isMembershipCodestring是否在籍,针对本科生,1-是，0-否
isMembershipNamestring是否在籍名称,针对本科生,
expGraduationDatestring预计毕业时间
enrolDateTIMESTAMP入学时间
offSchoolstring离校时间
teacherIdstring导师工号
viceTeacherIdstring副导师工号
isIncumbencyCodestring是否在职，针对研究生，本科生此字段为空，1-是，0-否
isIncumbencyNamestring是否在职名称，针对研究生，本科生此字段为空
userTypeCodestring人员类型代码types
userTypeNamestring人员类型名称
registrationStatusCodestring学籍状态，针对本科生registration_status_code
registrationStatusNamestring学籍状态名称，针对本科生
statusCodestring人员身份认证状态，0代表有效、1代表失效
statusNamestring人员身份认证状态名称
trainingCategoryCodestring培养类别training_category_code
trainingCategoryNamestring培养类别名称
lengthSchoolingstring学制
isOverseasCodestring是否留学生代码
isOverseasNamestring是否留学生
updateTimedate更新时间
managementCollege2Codestring管理学院2代码
managementCollege2Namestring管理学院2

解释说明

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

请求示例

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

返回示例

{
  "code": "A00000",
  "data": {
    "count": 27,
    "sinceUserId": "2******4",
    "userInfos": [
      {
        "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": "成功"
}
教职工指导学生信息学生基本信息-实时