CaμsAPI 接口定义
7. 学生学期课表获取
功能介绍:
- 开发者通过此 API 获取学生本学期的课表信息
接口: /curriculum/{username}
请求类型:POST
请求参数:
{
"apikey": "API Key",
"apisecret": "API Secret Key"
}
返回结果:
- 学生学期课表获取成功
Response 200
{
"message": "Success",
"username": "Request username",
"classes": [
{
"coursename": "Course name",
"courseid": "a semantic identifier for courses",
"time": [day, period],
"teacher": "Teacher",
"classroom": "Classroom",
"week": array of 0/1 whose length equals 16
}
]
}
参数说明:
字段 | 含义 | 备注 |
---|---|---|
day | 周一~周日 | 1~7,代表周一~周日 |
period | 第一大节~第六大节 | 1~6, 代表第一大节~第六大节 |
week | 课程周数分布 | 值为字符串类型的长度为16的数组,元素为 0 或 1,表示某一周是否有此课 |
参数示例:
Response 200
{
"message": "Success",
"username": "mzj14",
"classes": [
{
"courseid": "2016-2017-1-34100294-0",
"coursename": "计算机与网络体系结构(1)",
"time": [3,2],
"teacher": "刘云浩",
"classroom": "六教6A209",
"week": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
},
{
"courseid": "2016-2017-1-34100294-0",
"coursename": "计算机与网络体系结构(1)",
"time": [3,2],
"teacher": "刘云浩",
"classroom": "六教6A209",
"week": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
}
]
}
- 学生学期课表获取失败 (即username非法)
Response 400
{
"message": "Failure",
"username": "Request username",
"reason": "Invalid username"
}