学生信息

报到注册信息

描述

学生报到注册信息

支持的模式

• authorization_code
• client_credentials
• password

请求方法

GET

请求地址

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

请求参数

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

返回参数

参数名	类型	备注
xh	string	学号
userId	string	学号
xn	string	学年
xq	string	学期
sfbd	number	是否报到，1是0不是
sfzc	number	是否注册，1是0不是
sfjf	number	是否缴费，1是0不是
zcsj	string	注册时间

请求示例

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

返回示例

{
	"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模式时可省略

返回参数

参数名	类型	备注
xh	string	学号
userId	string	学号
sfsx	number	是否生效，1是0不是
dl	string	异动大类
xl	string	异动小类，研究生独有字段
sqly	string	异动申请理由

请求示例

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

返回示例

{
	"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模式时可省略

返回参数

参数名	类型	备注
studentTags	string	学生标记
studentType	string	学生类型
formalCampusName	number	住宿校区
name	string	学生姓名
formalFloor	string	楼层
formalGroupName	string	公寓区
formalBunk	string	床位号
formalBuildingName	string	楼名
formalCondition	string	住宿状态
userId	string	学号

请求示例

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

返回示例

{
	"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模式时可省略

返回参数

参数名	类型	备注
wgx	string	违规项
wgTime	string	违规时间
userId	string	学号

请求示例

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

返回示例

{
	"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模式时可省略

返回参数

参数名	类型	备注
xh	string	学号
instructorName	string	辅导员姓名
instructorZgh	string	辅导员工号
xm	string	学生姓名
beginTime	string	开始时间
userId	string	用户名，即学号

请求示例

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

返回示例

{
  "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模式时可省略

返回参数

参数名	类型	备注
xh	string	学号
xm	string	学生姓名
cflb	string	处分类别
wjqk	string	违纪情况
cfwh	string	处分文号
cfrq	string	处分日期
userId	string	用户名，即学号

请求示例

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

返回示例

{
  "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	是	部门编号

返回参数

参数名	类型	备注
name	string	学生姓名
userId	string	职工号
departmentId	string	部门编号
departmentName	string	部门名称
type	string	负责人类型

请求示例

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

返回示例

{
  "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	否	学期，仅当学年不为空时有意义，查询该学年该学期下的助教信息

返回参数

参数名	类型	备注
xh	string	学号
xm	string	学生姓名
xn	string	学年
xq	string	学期
sqsj	string	申请时间
kcxx	string	课程信息
userId	string	用户名，即学号

请求示例

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

返回示例

{
	"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），请根据实际情况进行处理

参数名	类型	备注
userId	String	用户ID
xh	String	学号
xm	String	姓名
jxbId	String	教学班ID
kcdm	String	课程代码
kcmc	String	课程名称，课程代码如空，则为无课程助教
dsgh	String	导师工号
xn	String	学年
xq	String	学期
RN	Number	序号

请求示例

通过助教学号查询

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查询

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

通过申请助教的导师查询

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

返回示例

{
	"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模式时可省略

返回参数

参数名	类型	备注
xh	string	学号
xm	string	学生姓名
xn	string	学年
sqsj	string	申请时间
userId	string	用户名，即学号

请求示例

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

返回示例

{
	"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

请求参数

参数名	类型	必填	说明
semester	String	是	学期，例如：2024上/2024暑期/2024下
pageNum	Integer	是	页码，从1开始
pageSize	Integer	是	每页记录数
type	String	否	用户类型，研究生/本科生

响应参数

参数名	类型	说明
rows	Array	注册信息列表
rows[].id	String	记录ID
rows[].user	String	用户学号
rows[].username	String	用户姓名
rows[].time	String	注册时间，格式：yyyy-MM-dd HH:mm:ss
rows[].result	String	注册结果，SUCCESS表示成功
rows[].device	String	注册设备，例如：WeChat
rows[].address	String	IP地址信息
rows[].location	String	地理位置坐标，格式：纬度,经度
rows[].type	String	用户类型
rows[].inSchool	String	是否在校内，可选值：校内/校外

响应示例

{
    "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

请求参数

参数名	类型	必填	说明
semester	String	是	学期，例如：2024上/2024暑期/2024下
userId	String	是	用户学工号

响应示例

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

如果请求失败，则返回如下错误：

{
  "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

请求参数

参数名	类型	必填	说明
xn	String	是	学年，例 2023-2024
pageNum	Integer	是	页码，从1开始
pageSize	Integer	是	每页记录数

返回参数

参数名	类型	说明
totalNum	Integer	总记录数
pageSize	Integer	每页记录数
pageNum	Integer	当前页码
rows	Array	记录列表
rows[].xn	String	学年
rows[].xh	String	学号
rows[].xm	String	姓名

响应示例

{
  "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
}