CaμsAPI 接口定义
6. 学生课程作业信息获取
功能介绍：
- 开发者通过此 API 获取学生本学期所学课程的作业信息
接口: /learnhelper/{username}/courses/{courseid}/assignments
请求类型：POST
请求参数：
{
"apikey": "API Key",
"apisecret": "API Secret Key"
}
返回结果：
- 学生课程作业信息获取成功
Response 200
{
"message": "Success",
"username": "Request username",
"assignments": [
{
"assignmentid": "Assignment ID",
"title": "Title",
"detail": "Detail of the assignment",
"startdate": Start date,
"duedate": Due date,
"scored": true/false
"evaluatingteacher": "Evaluating teacher",
"evaluatingdate": Evaluating date,
"comment": "Comment from teacher",
"grade": Grade of the homework,
"filename": "File name",
"fileurl": "File url",
"size": "file size"
"state": "已经提交/尚未提交"
}
]
}
参数说明：
| 字段 | 含义 | 备注 |
|---|---|---|
| assignmentid | 作业id | 字符串类型的正整数，可保证所有作业id互异 |
| scored | 作业是否被批改 | true表示已被批改 |
| grade | 作业评分 | 浮点数, -1表示此作业并无评分 |
| startdate、duedate、evaluatingdate | 值为时间戳(ms为单位,以东八区为基准) |
- 学生课程作业信息获取失败 (即username/courseid非法)
参考示例：
{
"username": "ysz14",
"message": "Success",
"assignments": [
{
"title": "计算机体系结构——第二章作业",
"startdate": 1475164800000,
"duedate": 1476633599000,
"state": "已经提交",
"size": "162.5KB",
"assignmentid": "714167",
"detail": "教材练习题：2.64，2.73，2.81",
"filename": "无相关文件",
"fileurl": "",
"evaluatingteacher": "",
"evaluatingdate": 1476806400000,
"scored": true,
"grade": 100,
"comment": ""
},
{
"title": "计算机体系结构——第二章作业2",
"startdate": 1476028800000,
"duedate": 1476633599000,
"state": "已经提交",
"size": "116.8KB",
"assignmentid": "715467",
"detail": "教材练习题：2.82，2.85，2.87",
"filename": "无相关文件",
"fileurl": "",
"evaluatingteacher": "",
"evaluatingdate": 1476979200000,
"scored": true,
"grade": -1,
"comment": ""
}
]
}
以上返回数据语义为:
计算机体系结构——第二章作业 已经被批改，成绩为100；
计算机体系结构——第二章作业2 已经被批改，但没有给出成绩
- 学生课程作业信息获取失败 (即username非法)
Response 400
{
"message": "Failure",
"username": "Request username",
"reason": "Invalid username"
}
- 学生课程作业信息获取失败 (courseid非法)
Response 400
{
"message": "Failure",
"username": "Request username",
"courseid": "Request courseid",
"reason": "Invalid courseID"
}