Skip to content

学生信息

报到注册信息

描述

学生报到注册信息

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/bdzc

请求参数

参数名是否必填备注
userId用户名,即学工号,当授权为authorization_code和password模式时可省略
xn学年
xq学期

返回参数

参数名类型备注
xhstring学号
userIdstring学号
xnstring学年
xqstring学期
sfbdnumber是否报到,1是0不是
sfzcnumber是否注册,1是0不是
sfjfnumber是否缴费,1是0不是
zcsjstring注册时间

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/bdzc?userId=10*****0007&xn=2020-2021&xq=2"

返回示例

json
{
	"data": [{
		"xh": "102******07",
		"sfbd": 1,
		"xn": "2020-2021",
		"sfzc": 1,
		"xq": "2",
		"sfjf": 1,
		"userId": "102******07"
	}],
	"errCode": 0,
	"requestId": "65841f9216232916333174561e2406",
	"errMsg": "success",
	"apiLog": null
}

学籍异动信息

描述

学生学籍异动信息

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/xjyd

请求参数

参数名是否必填备注
userId用户名,即学工号,当授权为authorization_code和password模式时可省略

返回参数

参数名类型备注
xhstring学号
userIdstring学号
sfsxnumber是否生效,1是0不是
dlstring异动大类
xlstring异动小类,研究生独有字段
sqlystring异动申请理由

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/bdzc?userId=52********23"

返回示例

json
{
	"data": [{
		"xh": "52********23",
		"sxrq": "2017-12-26 00:00:00",
		"xl": "延期",
		"dl": "延期",
		"userId": "52********23",
		"sfsx": 1,
		"sqly": "由于********,希望能够2018年5月份毕业。"
	}, {
		"xh": "52********23",
		"sxrq": "2018-05-30 00:00:00",
		"xl": "延期",
		"dl": "延期",
		"userId": "52********23",
		"sfsx": 1,
		"sqly": "由于********,申请延期一年"
	}, {
		"xh": "52********23",
		"sxrq": "2019-03-07 00:00:00",
		"xl": "延期",
		"dl": "延期",
		"userId": "52********23",
		"sfsx": 1,
		"sqly": "********,延期至2019年8月毕业"
	}],
	"errCode": 0,
	"requestId": "6a0f0e4b16232922467608797e527b",
	"errMsg": "success",
	"apiLog": null
}

学生住宿信息

描述

学生住宿信息

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/accommodation

请求参数

参数名是否必填备注
userId用户名,即学工号,当授权为authorization_code和password模式时可省略

返回参数

参数名类型备注
studentTagsstring学生标记
studentTypestring学生类型
formalCampusNamenumber住宿校区
namestring学生姓名
formalFloorstring楼层
formalGroupNamestring公寓区
formalBunkstring床位号
formalBuildingNamestring楼名
formalConditionstring住宿状态
userIdstring学号

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/accommodation?userId=52********23"

返回示例

json
{
	"data": [{
		"studentTags": "",
		"studentType": "博士",
		"formalCampusName": "中北校区",
		"name": "***",
		"formalFloor": "2",
		"formalGroupName": "中山北路公寓",
		"formalRoomName": "230",
		"formalBunk": "2",
		"formalBuildingName": "中山北路17#楼",
		"userId": "52******23",
		"formalCondition": "已退宿"
	}],
	"requestId": "6a0f0ef016232925877704955e05cf",
	"errCode": 0,
	"errMsg": "success",
	"apiLog": null
}

学生宿舍违规信息

描述

学生宿舍违规信息

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/wgxx

请求参数

参数名是否必填备注
userId用户名,即学工号,当授权为authorization_code和password模式时可省略

返回参数

参数名类型备注
wgxstring违规项
wgTimestring违规时间
userIdstring学号

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/wgxx?userId=52********23"

返回示例

json
{
	"data": [{
		"wgx": "电饭锅",
		"userId": "52*******23",
		"wgTime": "2017-12-21 00:00:00"
	}],
	"errCode": 0,
	"requestId": "65841fdd16232928266318275e62a5",
	"errMsg": "success",
	"apiLog": null
}

学生辅导员关系

描述

根据学号查询辅导员关系

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/stuins

请求参数

参数名是否必填备注
userId用户名,即学号,当授权为authorization_code和password模式时可省略

返回参数

参数名类型备注
xhstring学号
instructorNamestring辅导员姓名
instructorZghstring辅导员工号
xmstring学生姓名
beginTimestring开始时间
userIdstring用户名,即学号

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/stuins?userId=52********23"

返回示例

json
{
  "data": [
    {
      "xh": "52*******23",
      "instructorName": "孙**",
      "xm": "李**",
      "instructorZgh": "20***44",
      "beginTime": "2021-05-12",
      "userId": "52*******23"
    }
  ],
  "errCode": 0,
  "requestId": "65841f9216260550820697963e7bbe",
  "errMsg": "success",
  "apiLog": null
}

学生未解除处分

描述

根据学号查询未解除处分

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/undisciplinary

请求参数

参数名是否必填备注
userId用户名,即学号,当授权为authorization_code和password模式时可省略

返回参数

参数名类型备注
xhstring学号
xmstring学生姓名
cflbstring处分类别
wjqkstring违纪情况
cfwhstring处分文号
cfrqstring处分日期
userIdstring用户名,即学号

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/undisciplinary?userId=52********23"

返回示例

json
{
  "data": [
    {
      "xh": "52********23",
      "xm": "李**",
      "cflb": "记过",
      "wjqk": "2021年1月20日******考试作弊",
      "cfwh": "华师学【***】**号",
      "cfrq": "2021-03-15",
      "userId": "52********23"
    }
  ],
  "errCode": 0,
  "requestId": "65841fdd16260553425572118e62ab",
  "errMsg": "success",
  "apiLog": null
}

院系负责人

描述

根据部门编号查询院系的学工负责人

支持的模式

  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/departmentadmin

请求参数

参数名是否必填备注
departmentId部门编号

返回参数

参数名类型备注
namestring学生姓名
userIdstring职工号
departmentIdstring部门编号
departmentNamestring部门名称
typestring负责人类型

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/departmentadmin?departmentId=0110"

返回示例

json
{
  "data": [
    {
      "name": "李**",
      "departmentId": "0110",
      "userId": "19*****1",
      "departmentName": "体育与健康学院",
      "type": "学工负责人"
    }
  ],
  "errCode": 0,
  "requestId": "65841fdd16260557305923813e62ab",
  "errMsg": "success",
  "apiLog": null
}

学生助教信息

描述

根据学号查询学生助教信息

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/assistant/teaching

请求参数

参数名是否必填备注
userId用户名,即学号,当授权为authorization_code和password模式时可省略
xn学年,当提供该参数时,查询该学年下的学生助教信息
xq学期,仅当学年不为空时有意义,查询该学年该学期下的助教信息

返回参数

参数名类型备注
xhstring学号
xmstring学生姓名
xnstring学年
xqstring学期
sqsjstring申请时间
kcxxstring课程信息
userIdstring用户名,即学号

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/student/assistant/teaching?userId=51*****01&xn=2021&xq=2"

返回示例

json
{
	"errCode": 0,
	"errMsg": "success",
	"requestId": "9436ee1f-2d4f-4039-a4e0-10223c3a070f",
	"data": [{
		"userId": "51*****01",
		"xh": "51******01",
		"xm": "黄**",
		"xn": "2021",
		"xq": "2",
		"sqsj": "2021-08-28",
		"kcxx": "现代生物学综合实验"
	}]
}

学生助教信息v2

描述

根据学号查询学生助教信息

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/student/assistant/teaching

请求参数

参数名是否必填备注
userId三选一用户名,即学号,当授权为authorization_code和password模式时可省略,且只会注入userId
jxbId三选一教学班ID,和开选课数据一致
dsgh三选一导师工号,即申请助教的老师(不一定是开课的老师)
xn学年(例:2023-2024)
xq学期(例如:2)

如果同时提供多个参数,优先级为:userId > jxbId > dsgh

读取学期学年对应的自然时间,详见以下两个接口

返回参数

注:根据实际情况,数据返回可能有多条(即 data 数组的长度大于1),请根据实际情况进行处理

参数名类型备注
userIdString用户ID
xhString学号
xmString姓名
jxbIdString教学班ID
kcdmString课程代码
kcmcString课程名称,课程代码如空,则为无课程助教
dsghString导师工号
xnString学年
xqString学期
RNNumber序号

请求示例

通过助教学号查询

bash
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/assistant/teaching?userId=51*****25&xn=2023-2024&xq=1"

通过教学班Id查询

bash
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/assistant/teaching?jxbId=EDTE0031131035.01&xn=2023-2024&xq=1"

通过申请助教的导师查询

bash
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/student/assistant/teaching?dsgh=****22&xn=2023-2024&xq=1"

返回示例

json
{
	"data": [{
		"userId": "51****25",
		"xh": "51****025",
		"xm": "**亮",
		"jxbId": "EDTE0031131035.01",
		"kcdm": "EDTE0031131035",
		"kcmc": "校园网建设与管理",
		"dsgh": "****22",
		"xn": "2023-2024",
		"xq": "1",
		"RN": 1
	}],
	"errCode": 0,
	"requestId": "65BB99BD-EE9B-49D5-8591-6B3B5121D281",
	"errMsg": "success",
	"apiLog": null
}

学生助管信息

描述

根据学号查询学生助管信息,仅返回当前学年的数据

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/assistant/management

请求参数

参数名是否必填备注
userId用户名,即学号,当授权为authorization_code和password模式时可省略

返回参数

参数名类型备注
xhstring学号
xmstring学生姓名
xnstring学年
sqsjstring申请时间
userIdstring用户名,即学号

请求示例

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

返回示例

json
{
	"errCode": 0,
	"errMsg": "success",
	"requestId": "505a14d9-be3f-4cf1-b045-502fa42f65ce",
	"data": [{
		"userId": "51****35",
		"xh": "51***35",
		"xm": "宋**",
		"xn": "2021",
		"sqsj": "2021-09-02 08:52:14"
	}]
}

获取学生注册信息列表(实时)

描述

实时获取用户注册信息的列表

支持的模式

  • authorization_code
  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/registration

请求参数

参数名类型必填说明
semesterString学期,例如:2024上/2024暑期/2024下
pageNumInteger页码,从1开始
pageSizeInteger每页记录数
typeString用户类型,研究生/本科生

响应参数

参数名类型说明
rowsArray注册信息列表
rows[].idString记录ID
rows[].userString用户学号
rows[].usernameString用户姓名
rows[].timeString注册时间,格式:yyyy-MM-dd HH:mm:ss
rows[].resultString注册结果,SUCCESS表示成功
rows[].deviceString注册设备,例如:WeChat
rows[].addressStringIP地址信息
rows[].locationString地理位置坐标,格式:纬度,经度
rows[].typeString用户类型
rows[].inSchoolString是否在校内,可选值:校内/校外

响应示例

json
{
    "errCode": 0,
    "errMsg": "success",
    "requestId": "9831dde1-896e-4544-afe5-a65d418a037e",
    "data": {
        "totalNum": 21698,
        "pageSize": 1,
        "rows": [
            {
                "id": "67c5****f0e",
                "user": "71*****0109",
                "username": "丁*",
                "time": "2025-03-03 19:33:30",
                "result": "SUCCESS",
                "device": "WeChat",
                "address": "223.246.*.*;202.120.*.*;null",
                "location": "32.000822,118.763783",
                "type": "研究生",
                "inSchool": "校外"
            }
        ]
    }
}

获取新生注册照片(实时)

描述

实时获取新生报到注册时采集的人脸图片

支持的模式

  • authorization_code
  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/registrationPhoto

请求参数

参数名类型必填说明
semesterString学期,例如:2024上/2024暑期/2024下
userIdString用户学工号

响应示例

如果请求成功,直接返回Content-Type: image/jpeg图片

如果请求失败,则返回如下错误:

json
{
  "errCode": 20002,
  "errMsg": "未找到照片文件",
  "requestId": "378deb25-8a89-4702-bf7b-8203d527f4dc",
  "data": null
}

获取学生资助绿色通道(实时)

描述

实时获学生资助绿色通道数据

支持的模式

  • authorization_code
  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/student/greenpath

请求参数

参数名类型必填说明
xnString学年,例 2023-2024
pageNumInteger页码,从1开始
pageSizeInteger每页记录数

返回参数

参数名类型说明
totalNumInteger总记录数
pageSizeInteger每页记录数
pageNumInteger当前页码
rowsArray记录列表
rows[].xnString学年
rows[].xhString学号
rows[].xmString姓名

响应示例

json
{
  "data": {
    "totalNum": 1827,
    "pageSize": 5,
    "rows": [
      {
        "xn": "2023-2024",
        "xh": "52******04",
        "xm": "刘*"
      },
      {
        "xn": "2023-2024",
        "xh": "10********17",
        "xm": "靳*"
      },
      {
        "xn": "2023-2024",
        "xh": "52******01",
        "xm": "吴*"
      },
      {
        "xn": "2023-2024",
        "xh": "52*****004",
        "xm": "顾*"
      },
      {
        "xn": "2023-2024",
        "xh": "51****4004",
        "xm": "潘*"
      }
    ],
    "pageNum": 1
  },
  "errCode": 0,
  "requestId": "45E5EC26-99DE-4ECA-91C6-0CFDCD365E77",
  "errMsg": "success",
  "apiLog": null
}