CaμsAPI 接口定义
11. 学生教学日历获取
功能介绍:
- 开发者通过此 API 获取学生本学期的课表信息
接口: /schedule/{username}/{week}
接口说明:week为[1, 18]的正整数,代表 1-18 教学周
请求类型:POST
请求参数:
{
"apikey": "API Key",
"apisecret": "API Secret Key"
}
返回结果:
- 学生学期课表获取成功
Response 200
{
"message": "Success",
"username": "Request username",
"weekschedule": [
{
"place": "class place",
"type": "上课/考试",
"starttime": "HH:MM",
"duetime": "HH:MM",
"date": "YYYY-MM-DD",
"content": "class name"
},
]
}
参数说明:
字段 | 含义 | 备注 |
---|---|---|
type | 活动类型 | 值为"上课"或者"考试" |
starttime | 开始时间 | 为"HH:MM" 格式字符串,注意HH开始的0可能被省略 |
参数示例:
- 学生教学日历获取成功
Response 200
{
"username": "mzj14",
"message": "Success",
"schedule": {
"week": 17,
"weekschedule": [
{
"place": "一教 104",
"type": "考试",
"starttime": "2:30",
"duetime": "4:30",
"date": "2017-01-04",
"content": "计算机与网络体系结构(1)"
}
]
}
}
- 学生教学日历获取失败 (即username非法)
Response 400
{
"message": "Failure",
"username": "Request username",
"reason": "Invalid username"
}