这是工程学导论的项目后端
若进行无权限操作，会返回
{
"detail": "You do not have permission to perform this action."
}若在要使用token的API中没有提交token ，则会返回
{
"detail": "Authentication credentials were not provided."
}若提交的token错误，返回
{
"detail": "Invalid token."
}Request
发送用户名及密码请求
{
"username": "student01",
"password": "student01"
}Response
返回token 及所属用户组
{
"token": "537410732a4317fb58f93bea97516e9e6c7a2fd4",
"groups": [
"student"
]
}以下所有老师或学生API 需要在header 中加入(tokeno值根据获得token)
Authorization: Token 537410732a4317fb58f93bea97516e9e6c7a2fd4
查询所有目前投票的简略情况，choicesCount为选项数量，title为投票标题，id 为投票对应编号
[
{
"id": 1,
"title": "1 + 1 = ?",
"choicesCount": 4,
"created": "2021-04-30T10:28:40.476611Z"
},
{
"id": 2,
"title": "3 + 1 = ?",
"choicesCount": 2,
"created": "2021-04-30T10:28:40.476611Z"
},
]Request
新增一个投票，需要 title（投票标题），choicesCount（选项数量）
{
"title" : "1 + 1 = ?",
"choicesCount" : 4,
"created": "2021-04-30T10:28:40.476611Z"
}Response
返回新增的投票的详细资料，order 为选项顺序，voteCount为投该选项人数
{
"id": 2,
"title": "3 + 1 = ?",
"choicesCount": 2,
"created": "2021-04-30T10:28:40.476611Z",
"choices": [
{
"order": 1,
"voteCount": 0
},
{
"order": 2,
"voteCount": 0
}
]
}此操作只有老师帐号有权限进行，若非老师帐户进行此操作，则返回
Reponse
查看对应 id 项的详细情况
{
"id": 2,
"title": "3 + 1 = ?",
"choicesCount": 2,
"created": "2021-04-30T10:28:40.476611Z",
"choices": [
{
"order": 1,
"voteCount": 0
},
{
"order": 2,
"voteCount": 0
}
]
}Request
对所请求的id的order 项投一票
{
"order" : 1
}Response
注意∶choices 里面的 order : 1 该选项的 voteCount 改变了
{
"id": 1,
"title": "3 + 1 = ?",
"choicesCount": 2,
"choices": [
{
"order": 1,
"voteCount": 1
},
{
"order": 2,
"voteCount": 0
}
]
}Response
返回是否已经对id对应的问题进行投票
{
"hasVote": true
}Response
获得所有的课堂反馈，feedbackType为反馈类型，有faster(讲快一点)，slower(讲慢一点)，notUnderstand(听不懂)，notClear(没听清)；created为反馈提交时间，可用于只显示最近反馈
[
{
"feedbackType": "faster",
"created": "2021-04-30T10:28:40.476611Z"
},
{
"feedbackType": "slower",
"created": "2021-04-30T10:29:59.852745Z"
}
]Request
提交一个反馈，需要参数有feedbackType(反馈类型)
{
"feedbackType":"faster"
}Response
返回提交返回的类型的提交时间
{
"feedbackType": "faster",
"created": "2021-04-30T10:28:40.476611Z"
}每次提交反馈后需要一分钟后才能提交下次反馈，若在一分钟内再次提交反馈，则返回
{
"detail": "Request was throttled. Expected available in 59 seconds."
}Request
创建一个新签到，标题为title
{
"title": "Attendance 01"
}Response
返回签到id，标题，创建时间。
{
"id": 1,
"title": "Attendance 01",
"created": "2021-05-18T08:42:20.960497Z"
}返回所有签到
[
{
"id": 1,
"title": "Attendance 01",
"created": "2021-05-18T08:42:20.960497Z"
},
{
"id": 2,
"title": "Attendance 02",
"created": "2021-05-18T08:53:20.960497Z"
},
]Reponse
进行签到
{
"success": true
}获取签到的详细内容，attendanceCount 为签到人数，users为签到用户的用户名
{
"id": 1,
"title": "Attendance 01",
"created": "2021-05-18T08:42:20.960497Z",
"attendanceCount": 1,
"users": [
"student01"
]
}查询是否已签到
{
"hasChecked" : true
}