Skip to content

教学信息

课程信息

描述

课程信息

支持的模式

  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/kcxx

请求参数

参数名是否必填备注
xq学期
xn学年
kcly课程来源,分为本科生和研究生,请求参数分别填“BKS”和“YJS”
pageNum分页第几页,从1开始
pageSize每页的数量

返回参数

参数名类型备注
totalNumnumber总共的条目数
pageSizenumber每页的大小
rowsobject array具体的返回
kclystring课程来源
jxbIdstring教学班ID
kcdmstring课程代码
kcmcstring课程名称
xfstring学分
bmdmstring部门代码
bmmcstring部门名称
xqstring学期
xnstring学年
kclxstring课程类型

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/education/kcxx?xq=1&xn=2021-2022&kcly=YJS&pageNum=1&pageSize=5"

返回示例

json
{
	"data": {
		"totalNum": 2001,
		"pageSize": 5,
		"rows": [{
			"jxbId": "YJS.******101001",
			"kcdm": "TY******01",
			"xn": "2021-2022",
			"kclx": "学术学位",
			"kcly": "YJS",
			"xq": "1",
			"bmdm": "010400",
			"kcmc": "语言、跨文化和全球素养",
			"xf": "2",
			"bmmc": "外语院部"
		}, {
			"jxbId": "YJS.******101001",
			"kcdm": "TY******01",
			"xn": "2021-2022",
			"kclx": "专业学位",
			"kcly": "YJS",
			"xq": "1",
			"bmdm": "010403",
			"kcmc": "英语",
			"xf": "2",
			"bmmc": "大学外语教学部"
		}, {
			"jxbId": "YJS.******101001",
			"kcdm": "TY******01",
			"xn": "2021-2022",
			"kclx": "专业学位",
			"kcly": "YJS",
			"xq": "1",
			"bmdm": "010403",
			"kcmc": "英语",
			"xf": "2",
			"bmmc": "大学外语教学部"
		}, {
			"jxbId": "YJS.******101001",
			"kcdm": "TY******01",
			"xn": "2021-2022",
			"kclx": "专业学位",
			"kcly": "YJS",
			"xq": "1",
			"bmdm": "010403",
			"kcmc": "英语",
			"xf": "2",
			"bmmc": "大学外语教学部"
		}, {
			"jxbId": "YJS.******101001",
			"kcdm": "TY******01",
			"xn": "2021-2022",
			"kclx": "专业学位",
			"kcly": "YJS",
			"xq": "1",
			"bmdm": "010403",
			"kcmc": "英语",
			"xf": "2",
			"bmmc": "大学外语教学部"
		}],
		"pageNum": 1
	},
	"errCode": 0,
	"requestId": "65841f9216375923231092485e1bf2",
	"errMsg": "success",
	"apiLog": null
}

开课信息_根据教师工号查询V1(兼容保留)

描述

根据教师工号查询开课信息,同一门课可能出现多条记录(多个上课地点)

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/kkxxbyuserid

请求参数

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

返回参数

参数名类型备注
kclystring课程来源,本科生或研究生
jxbIdstring教学班ID
kcdmstring课程代码
kcmcstring课程名称
xkrsnumber选课人数
bmmcstring开课的部门名称
bmdmstring开课的部门代码
kclxstring课程类型
xfstring学分
zghstring教职工工号
userIdstring教职工工号
xqstring学期
xnstring学年
djzstring一学期上课的周次,1代表上课,0代表不上课。
zjstring上课的具体日期(周几),例如星期一,则是1,依此类推。
jcstring上课的节次,例如第一节到第三节,为1-2,依此类推
skddstring上课地点

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/education/kkxx/byuserid?xq=1&xn=2021-2022&userId=19***97"

返回示例

json
{
    "errCode": 0,
    "errMsg": "success",
    "requestId": "cb3873e9-8c8d-454e-897f-7de8e19df7c1",
    "data": [
        {
            "kcly": "BKS",
            "jxbId": "CHEM*********01",
            "userId": "19***97",
            "xh": "19***97",
            "xq": "2",
            "xn": "2021-2022",
            "kcdm": "CHE*********02",
            "kcmc": "有机化学实验(II)",
            "xf": "2",
            "bmdm": "014301",
            "bmmc": "化学系",
            "kclx": "主修",
            "xkrs": 33,
            "djz": "00111111111111111000000000000000000000000000000000000",
            "zj": "2",
            "jc": "6-9",
            "skdd": "闵实验D507"
        }
    ]
}

开课信息_根据教师工号查询V2

描述

根据教师工号查询开课信息 v2中一门课的多个上课地点会合并在 members 数组中,以更简化开发者使用。

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/education/kkxx/byuserid

请求参数

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

返回参数

参数名类型备注
kclystring课程来源,本科生或研究生
jxbIdstring教学班ID
kcdmstring课程代码
kcmcstring课程名称
xkrsnumber选课人数
bmmcstring开课的部门名称
bmdmstring开课的部门代码
kclxstring课程类型
xfstring学分
zghstring教职工工号
userIdstring教职工工号
xqstring学期
xnstring学年
membersobject orray上课地点,可能有多个
djzstring一学期上课的周次,1代表上课,0代表不上课。
zjstring上课的具体日期(周几),例如星期一,则是1,依此类推。
jcstring上课的节次,例如第一节到第三节,为1-2,依此类推
skddstring上课地点

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/education/kkxx/byuserid?xq=1&xn=2021-2022&userId=19***97"

返回示例

json
{
    "errCode": 0,
    "errMsg": "success",
    "requestId": "cb3873e9-8c8d-454e-897f-7de8e19df7c1",
    "data": [
        {
            "kcly": "BKS",
            "jxbId": "CHEM*********01",
            "userId": "19***97",
            "xh": "19***97",
            "xq": "2",
            "xn": "2021-2022",
            "kcdm": "CHE*********02",
            "kcmc": "有机化学实验(II)",
            "xf": "2",
            "bmdm": "014301",
            "bmmc": "化学系",
            "kclx": "主修",
            "xkrs": 33,
            "members": [
                {
                    "djz": "00111111111111111000000000000000000000000000000000000",
                    "zj": "2",
                    "jc": "6-9",
                    "skdd": "闵实验D507"
                },
                {
                    "djz": "00111111111111111000000000000000000000000000000000000",
                    "zj": "2",
                    "jc": "6-9",
                    "skdd": "闵实验D503"
                },
                {
                    "djz": "00111111111111111000000000000000000000000000000000000",
                    "zj": "2",
                    "jc": "6-9",
                    "skdd": "闵实验D514"
                }
            ]
        }
    ]
}

开课信息_根据jxbid查询

描述

根据jxbid查询开课信息

支持的模式

  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/kkxxbyjxbid

请求参数

参数名是否必填备注
xq学期
xn学年
jxbid教学班ID
kcly课程来源,本科生或研究生,请求参数填"BKS"或"YJS"

返回参数

参数名类型备注
kclystring课程来源,本科生或研究生
jxbIdstring教学班ID
zghstring教职工工号
xqstring学期
xnstring学年
djzstring一学期上课的周次,1代表上课,0代表不上课。
zjstring上课的具体日期(周几),例如星期一,则是1,依此类推。
jcstring上课的节次,例如第一节到第三节,为1-2,依此类推
skddstring上课地点

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/education/kkxxbyjxbid?xq=2&xn=2019-2020&jxbId=Y************3&kcly=YJS"

返回示例

json
{
  "data": [
    {
      "zj": "1",
      "jxbId": "YJS.***********************143",
      "djz": "0000000000111100000000000",
      "xn": "2019-2020",
      "kcly": "YJS",
      "jc": "5-8",
      "xq": "2",
      "zgh": "2******0",
      "skdd": "其它,null"
    },
    {
      "zj": "1",
      "jxbId": "YJS.***********************143",
      "djz": "0000000000111100000000000",
      "xn": "2019-2020",
      "kcly": "YJS",
      "jc": "5-6",
      "xq": "2",
      "zgh": "2******0",
      "skdd": "中北,中北文附楼,文附楼215"
    }
  ],
  "requestId": "65841f9216232240646063108e2407",
  "errCode": 0,
  "errMsg": "success",
  "apiLog": null
}

选课信息_根据学号查询v1(兼容保留)

描述

根据学号查询选课信息,一门课可能有多条记录(多个上课地点或多个老师)

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/xkxxbyuserid

请求参数

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

返回参数

参数名类型备注
kclystring课程来源,本科生或研究生
jxbIdstring教学班ID
kcdmstring课程代码
kcmcstring课程名称
bmmcstring开课的部门名称
bmdmstring开课的部门代码
kclxstring课程类型
xfstring学分
tsstring选课时间,yyyy-mm-dd hh:mm:ss
statusstring选课状态
userIdstring用户名,即学号
xhstring学号
xqstring学期
xnstring学年
jsghstring开课教师工号
jsxmstring开课教师姓名
djzstring一学期上课的周次,1代表上课,0代表不上课。
zjstring上课的具体日期(周几),例如星期一,则是1,依此类推。
jcstring上课的节次,例如第一节到第三节,为1-2,依此类推
skddstring上课地点

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/education/xkxx/byuserid?xq=1&xn=2019-2020&userId=1*********5"

返回示例

json
{
    "errCode": 0,
    "errMsg": "success",
    "requestId": "523177c1-5d58-4a45-a460-282652a34448",
    "data": [
        {
            "kcly": "BKS",
            "jxbId": "BIO*************02",
            "userId": "10******35",
            "xh": "10******35",
            "xq": "2",
            "xn": "2021-2022",
            "ts": "2021-09-15 23:00:00",
            "status": "选课成功",
            "kcdm": "BIO*********1",
            "kcmc": "有机化学实验",
            "xf": "1",
            "bmdm": "011301",
            "bmmc": "生物学系",
            "kclx": "主修",
            "jsgh": "20****60",
            "jsxm": "刘*才",
            "djz": "00101010101010101000000000000000000000000000000000000",
            "zj": "2",
            "jc": "6-9",
            "skdd": "闵实验D418"
        }
    ]
}

选课信息_根据学号查询v2

描述

根据学号查询选课信息 v2中一门课的多个上课地点会合并在 members 数组中,以更简化开发者使用。

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v2/education/xkxx/byuserid

请求参数

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

返回参数

参数名类型备注
kclystring课程来源,本科生或研究生
jxbIdstring教学班ID
kcdmstring课程代码
kcmcstring课程名称
bmmcstring开课的部门名称
bmdmstring开课的部门代码
kclxstring课程类型
xfstring学分
tsstring选课时间,yyyy-mm-dd hh:mm:ss
statusstring选课状态
userIdstring用户名,即学号
xhstring学号
xqstring学期
xnstring学年
membersobject orray上课老师及上课时间地点(可能有多个老师在不同地点上课)
jsghstring开课教师工号
jsxmstring开课教师姓名
djzstring一学期上课的周次,1代表上课,0代表不上课。
zjstring上课的具体日期(周几),例如星期一,则是1,依此类推。
jcstring上课的节次,例如第一节到第三节,为1-2,依此类推
skddstring上课地点

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v2/education/xkxx/byuserid?xq=1&xn=2019-2020&userId=1*********5"

返回示例

json
{
    "errCode": 0,
    "errMsg": "success",
    "requestId": "523177c1-5d58-4a45-a460-282652a34448",
    "data": [
        {
            "kcly": "BKS",
            "jxbId": "BIO*************02",
            "userId": "10******35",
            "xh": "10******35",
            "xq": "2",
            "xn": "2021-2022",
            "ts": "2021-09-15 23:00:00",
            "status": "选课成功",
            "kcdm": "BIO*********1",
            "kcmc": "有机化学实验",
            "xf": "1",
            "bmdm": "011301",
            "bmmc": "生物学系",
            "kclx": "主修",
            "members": [
                {
                    "jsgh": "20****60",
                    "jsxm": "刘*才",
                    "djz": "00101010101010101000000000000000000000000000000000000",
                    "zj": "2",
                    "jc": "6-9",
                    "skdd": "闵实验D418"
                },
                {
                    "jsgh": "20****43",
                    "jsxm": "姜*琴",
                    "djz": "00101010101010101000000000000000000000000000000000000",
                    "zj": "2",
                    "jc": "6-9",
                    "skdd": "闵实验D418"
                },
                {
                    "jsgh": "20****92",
                    "jsxm": "王*",
                    "djz": "00101010101010101000000000000000000000000000000000000",
                    "zj": "2",
                    "jc": "6-9",
                    "skdd": "闵实验D418"
                }
            ]
        }
    ]
}

选课信息_根据jxbid查询

描述

根据jxbid查询选课信息

支持的模式

  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/xkxxbyjxbid

请求参数

参数名是否必填备注
xq学期
xn学年
jxbId教学班ID
kcly课程来源,本科生或研究生,请求参数填"BKS"或"YJS"

返回参数

参数名类型备注
kclystring课程来源,本科生或研究生
jxbIdstring教学班ID
xhstring学生学号
xqstring学期
xnstring学年
tsbigint选课时间戳
statusstring选课状态

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/education/xkxxbyjxbid?xq=1&xn=2019-2020&jxbId=YJS*********************027&kcly=YJS"

返回示例

json
{
  "data": [
    {
      "xh": "51********1",
      "jxbId": "YJS**********************027",
      "status": "退课",
      "xn": "2019-2020",
      "kcly": "YJS",
      "xq": "1",
      "ts": 1560738499000
    },
    {
      "xh": "51********2",
      "jxbId": "YJS**********************027",
      "status": "选课成功",
      "xn": "2019-2020",
      "kcly": "YJS",
      "xq": "1",
      "ts": 1560738499000
    },
    ......
    {
      "xh": "51********3",
      "jxbId": "YJS**********************027",
      "status": "选课成功",
      "xn": "2019-2020",
      "kcly": "YJS",
      "xq": "1",
      "ts": 1560738499000
    },
    {
      "xh": "51********4",
      "jxbId": "YJS**********************027",
      "status": "选课成功",
      "xn": "2019-2020",
      "kcly": "YJS",
      "xq": "1",
      "ts": 1560738499000
    }
  ],
  "errCode": 0,
  "requestId": "65841f9216232246763223760e240d",
  "errMsg": "success",
  "apiLog": null
}

本科生学期信息

描述

查询本科生学期信息,默认返回所有学期信息,输入时间返回所在学期。

支持的模式

  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/semester/bks

请求参数

参数名是否必填备注
pageNum分页第几页,从1开始
pageSize每页的数量
currentXq如果给定参数,则仅返回当前学期

返回参数

参数名类型备注
totalNumnumber总共的条目数
pageSizenumber每页的大小
rowsobject array具体的返回
beginOnstring学期开始时间
endOnstring学期结束时间
schoolYearstring学年
semesterNamestring即开选课中的学期(xq)

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/education/semester/bks?pageNum=1&pageSize=5"

返回示例

json
{
  "data": {
    "totalNum": 50,
    "pageSize": 5,
    "rows": [
      {
        "beginOn": "2004-09-05 00:00:00",
        "semesterName": "1",
        "endOn": "2005-01-24 00:00:00",
        "schoolYear": "2004-2005"
      },
      {
        "beginOn": "2005-02-28 00:00:00",
        "semesterName": "2",
        "endOn": "2005-07-25 00:00:00",
        "schoolYear": "2004-2005"
      },
      {
        "beginOn": "2004-02-08 00:00:00",
        "semesterName": "2",
        "endOn": "2004-06-28 00:00:00",
        "schoolYear": "2003-2004"
      },
      {
        "beginOn": "2003-08-31 00:00:00",
        "semesterName": "1",
        "endOn": "2004-01-05 00:00:00",
        "schoolYear": "2003-2004"
      },
      {
        "beginOn": "2003-02-16 00:00:00",
        "semesterName": "2",
        "endOn": "2003-07-07 00:00:00",
        "schoolYear": "2002-2003"
      }
    ],
    "pageNum": 1
  },
  "errCode": 0,
  "requestId": "6a0f0ef016326390814854673e687a",
  "errMsg": "success",
  "apiLog": null
}

研究生学期信息

描述

查询研究生学期信息,默认返回所有学期信息,输入时间返回所在学期。

支持的模式

  • client_credentials

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/semester/yjs

请求参数

参数名是否必填备注
pageNum分页第几页,从1开始
pageSize每页的数量
currentXq如果给定参数,则仅返回当前学期

返回参数

参数名类型备注
totalNumnumber总共的条目数
pageSizenumber每页的大小
rowsobject array具体的返回
beginOnstring学期开始时间
endOnstring学期结束时间
schoolYearstring学年
semesterNamestring第几学期

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/education/semester/yjs?pageNum=1&pageSize=10"

返回示例

json
{
	"data": {
		"totalNum": 8,
		"pageSize": 10,
		"rows": [{
			"beginOn": "2020-06-29 00:00:00",
			"semesterName": 3,
			"endOn": "2020-09-06 00:00:00",
			"schoolYear": "2020-2021"
		}, {
			"beginOn": "2020-09-14 00:00:00",
			"semesterName": 1,
			"endOn": "2021-01-24 00:00:00",
			"schoolYear": "2020-2021"
		}, {
			"beginOn": "2021-01-25 00:00:00",
			"semesterName": 4,
			"endOn": "2021-02-27 00:00:00",
			"schoolYear": "2020-2021"
		}, {
			"beginOn": "2021-03-01 00:00:00",
			"semesterName": 2,
			"endOn": "2021-07-04 00:00:00",
			"schoolYear": "2020-2021"
		}, {
			"beginOn": "2021-07-05 00:00:00",
			"semesterName": 3,
			"endOn": "2021-08-29 00:00:00",
			"schoolYear": "2021-2022"
		}, {
			"beginOn": "2021-09-06 00:00:00",
			"semesterName": 1,
			"endOn": "2022-01-09 00:00:00",
			"schoolYear": "2021-2022"
		}, {
			"beginOn": "2022-01-10 00:00:00",
			"semesterName": 4,
			"endOn": "2022-02-13 00:00:00",
			"schoolYear": "2021-2022"
		}, {
			"beginOn": "2022-02-21 00:00:00",
			"semesterName": 2,
			"endOn": "2022-06-26 00:00:00",
			"schoolYear": "2021-2022"
		}],
		"pageNum": 1
	},
	"errCode": 0,
	"requestId": "a9fef69716414368911875210e",
	"errMsg": "success",
	"apiLog": null
}

本科生考试信息

描述

根据学号查询本科生考试信息。

支持的模式

  • authorization_code
  • client_credentials
  • password

请求方法

GET

请求地址

https://api.ecnu.edu.cn/api/v1/education/exam

请求参数

参数名是否必填备注
userId学生学号,当授权为authorization_code和password模式时可省略
xn学年
xq学期,其中第3学期为暑期

返回参数

参数名类型备注
ksqkstring考试情况
kcdmstring课程代码
ksrqstring考试日期
ksapstring考试安排
kslxstring考试类型
xnstring学年
kslystring考生来源
xqstring学期
ksddstring考试地点
userNamestring学生姓名
kcmcstring课程名称
userIdstring学生学号

请求示例

curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/education/exam?xn=2020-2021&xq=2&userId=101******29"

返回示例

json
{
  "data": [
    {
      "ksqk": "正常",
      "kcdm": "BUSI****************01",
      "ksrq": "2021-06-28",
      "ksap": "第18周 星期1 13:00-15:00",
      "kslx": "期末考试",
      "xn": "2020-2021",
      "ksly": "BKS",
      "xq": "2",
      "ksdd": "闵一教219",
      "userName": "张*诚",
      "kcmc": "物流与供应链管理",
      "userId": "101******29"
    },
    {
      "ksqk": "正常",
      "kcdm": "BUSI*****************01",
      "ksrq": "2021-06-29",
      "ksap": "第18周 星期2 10:30-12:30",
      "kslx": "期末考试",
      "xn": "2020-2021",
      "ksly": "BKS",
      "xq": "2",
      "ksdd": "闵一教219",
      "userName": "张*诚",
      "kcmc": "战略管理",
      "userId": "101******29"
    },
    {
      "ksqk": "缓考",
      "kcdm": "ACC************01",
      "ksrq": "2021-06-29",
      "ksap": "第18周 星期2 10:30-12:30",
      "kslx": "期末考试",
      "xn": "2020-2021",
      "ksly": "BKS",
      "xq": "2",
      "ksdd": "闵一教223",
      "userName": "张*诚",
      "kcmc": "审计学",
      "userId": "101******29"
    },
    {
      "ksqk": "正常",
      "kcdm": "BUS***************01",
      "ksrq": "2021-06-30",
      "ksap": "第18周 星期3 10:30-12:30",
      "kslx": "期末考试",
      "xn": "2020-2021",
      "ksly": "BKS",
      "xq": "2",
      "ksdd": "闵一教218",
      "userName": "张*诚",
      "kcmc": "质量管理",
      "userId": "101******29"
    },
    {
      "ksqk": "正常",
      "kcdm": "REE*************01",
      "ksrq": "2021-07-01",
      "ksap": "第18周 星期4 15:30-17:30",
      "kslx": "期末考试",
      "xn": "2020-2021",
      "ksly": "BKS",
      "xq": "2",
      "ksdd": "闵一教223",
      "userName": "张*诚",
      "kcmc": "组织行为学",
      "userId": "101******29"
    },
    {
      "ksqk": "正常",
      "kcdm": "ACC**************01",
      "ksrq": "",
      "ksap": "",
      "kslx": "缓考",
      "xn": "2020-2021",
      "ksly": "BKS",
      "xq": "2",
      "ksdd": "",
      "userName": "张*诚",
      "kcmc": "审计学",
      "userId": "101******29"
    }
  ],
  "requestId": "65841f9216326406834834068e49ab",
  "errCode": 0,
  "errMsg": "success",
  "apiLog": null
}