URL:http://39.107.102.246/user/register
请求方式:POST
请求参数样例:
{
"name":"test",
"password":"123456",
"email":"test@qq.com"
}成功返回样例:
{
"status": 0,
"msg": "注册成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 用户名已存在 |
| -1 | 该邮箱已注册 |
| -3 | 缺少参数 |
URL:http://39.107.102.246/user/login
请求方式:POST
请求参数样例:
{
"name":"test",
"password":"123456",
"autoLogin":true
}
//autoLogin参数可选,默认为false成功返回样例:
{
"status": 0,
"msg": "登录成功",
"data": {
"name": "test",
"identity": 0,
"email": "test@qq.com"
}
}失败信息:
| status | msg |
|---|---|
| -2 | 用户名或密码错误 |
| -3 | 缺少参数 |
URL:http://39.107.102.246/user/login/auto
请求方式:POST
请求参数样例:无
成功返回样例:
{
"status": 0,
"msg": "登陆成功",
"data": {
"name": "test",
"identity": 0,
"email": "test@qq.com"
}
}失败信息:
| status | msg |
|---|---|
| -2 | 登录失败 |
| -3 | 缺少参数 |
URL:http://39.107.102.246/user/logout
请求方式:POST
请求参数样例:无
成功返回样例:
{
"status": 0,
"msg": "退出登录成功"
}失败信息:无
URL:http://39.107.102.246/teacher/course/list
请求方式:GET
请求参数样例:无
成功返回样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "81f88387543743328b30d7b299f33c01",
"name": "API开发",
"image": "0478f16dfa5946a887ecb3b6610d8074",
"teacher": "李老师",
"tag": "web;API;开发",
"finalExam": "d4daf49c80cb4e548b9711720c319bcb"
}
]
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 权限不足 |
URL:http://39.107.102.246/teacher/course/spinner
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "81f88387543743328b30d7b299f33c01",
"name": "API开发"
},
{
"id": "096702b7aab44441815622f4788df63b",
"name": "API开发"
}
]
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 权限不足 |
URL:http://39.107.102.246/teacher/course
请求方法:POST
请求参数样例:
| 参数名 | 参数类型 | 参数值 |
|---|---|---|
| name | text | API开发 |
| tag(可选) | text | web;API;开发 |
| imageFile(可选) | file | image.jpg |
成功返回样例:
{
"status": 0,
"msg": "创建成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 创建失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
URL:http://39.107.102.246/teacher/course/{课程ID}
请求方法:PUT
请求参数样例:
{
"name":"API开发",
"tag":"web;API;开发"
}
//所有参数均为可选参数,但request body必须要有JSON结构成功返回样例:
{
"status": 0,
"msg": "更新成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 更新失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/teacher/course/{课程ID}
请求方法:DELETE
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "删除成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 删除失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -4 | 课程不存在 |
URL:localhost:8080/teacher/course/notice
请求方法:POST
请求参数样例:
{
"course":"81f88387543743328b30d7b299f33c01",
"content":"公告"
}返回成功样例:
{
"status": 0,
"msg": "创建成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 创建失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
详见章节列表
URL:http://39.107.102.246/teacher/chapter
请求方法:POST
请求参数样例:
| 参数名 | 参数类型 | 参数值 |
|---|---|---|
| num(可选) | text | 1 |
| course | text | 3586967d6ee645f88de5f56cf99551b8 |
| name | text | API开发 |
| info | text | web;API;开发 |
| videoFile(可选) | file | video.mp4 |
返回成功样例:
{
"status": 0,
"msg": "创建成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 创建失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/teacher/chapter/{章节ID}
请求方法:PUT
请求参数样例:
{
"name":"API第一课",
"info":"API第一课"
}
//所有参数均为可选参数,但request body必须要有JSON结构返回成功样例:
{
"status": 0,
"msg": "更新成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 更新失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 章节不存在 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/teacher/chapter/{章节ID}
请求方法:DELETE
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "删除成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 删除失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -4 | 章节不存在 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/teacher/statistics/student
请求方法:GET
请求参数样例:?course=82ca0f2515624098b269341ea15db3a4
返回成功样例:
{
"status": 0,
"msg": "无人参加该课程"
}{
"status": 0,
"msg": "查询成功",
"data": {
"total": 4,
"nameList": [
"nic",
"15699999999",
"15610492887",
"redefault"
]
}
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/statistics/score
请求方法:GET
请求参数样例:?exam=a0f94e7f7e9945738f3e7e52d665a1db
返回成功样例:
{
"status": 0,
"msg": "无人参加该测试"
}{
"status": 0,
"msg": "查询成功",
"data": {
"total": 4,
"passNum": 2,
"passNumPercent": "50",
"scoreList": [
{
"name": "test",
"score": 20
},
{
"name": "test",
"score": 20
},
{
"name": "test",
"score": 100
},
{
"name": "test",
"score": 100
}
],
"perfectPercent": "50",
"excellentPercent": "0",
"goodPercent": "0",
"passPercent": "0",
"failPercent": "50"
}
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
| -4 | 章节不存在 |
| -4 | 考试不存在 |
URL:http://39.107.102.246/exam/final
请求方法:POST
请求参数样例:
{
"name":"API开发期末考试",
"course":"81f88387543743328b30d7b299f33c01",
"startTime":"2019-04-21 07:00:00",
"stopTime":"2019-04-21 09:00:00",
"choiceScoreWeight":1,
"choiceList":[
{
"question":"一天有多少小时?",
"optionList":[
"5小时",
"10小时",
"20小时",
"24小时"
],
"answer":"24小时"
},
{
"question":"一小时有多少分钟?",
"optionList":[
"10分钟",
"30分钟",
"60分钟",
"90分钟"
],
"answer":"60分钟"
}
],
"judgementScoreWeight":1,
"judgementList":[
{
"question":"青岛工学院是双一流大学.",
"answer":"false"
},
{
"question":"BTA指的是百度,腾讯和阿里爸爸.",
"answer":"true"
}
]
}
//考试开始时间必须在当前时间之前,在结束时间之后,时长在5分钟至24小时之间返回成功样例:
{
"status": 0,
"msg": "创建成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 创建失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 考试时间错误 |
| -4 | 课程不存在 |
| -4 | 有效题目不足 |
URL:http://39.107.102.246/exam/final/{考试ID}
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": {
"name": "API开发期末考试",
"choiceList": [
{
"id": 1,
"question": "一天有多少小时?",
"score": 5,
"optionList": [
"10小时",
"20小时",
"5小时",
"24小时"
]
},
{
"id": 2,
"question": "一小时有多少分钟?",
"score": 5,
"optionList": [
"90分钟",
"60分钟",
"10分钟",
"30分钟"
]
}
],
"judgementList": [
{
"id": 4,
"question": "BTA指的是百度,腾讯和阿里爸爸.",
"score": 5
},
{
"id": 3,
"question": "青岛工学院是双一流大学.",
"score": 5
}
],
"startTime": "2019-04-20 07:00:00",
"stopTime": "2019-04-20 09:00:00"
}
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 未参加学习 |
| -4 | 考试不存在 |
| -4 | 课程不存在 |
| -4 | 不在考试时间 |
URL:http://39.107.102.246/exam/final/{考试ID}
请求方法:POST
请求参数样例:
{
"choiceList":[
{
"id":1,
"answer":"24小时"
},
{
"id":2,
"answer":"60分钟"
}
],
"judgementList":[
{
"id":3,
"answer":false
},
{
"id":4,
"answer":true
}
]
}返回成功样例:
{
"status": 0,
"msg": "提交成功",
"data": {
"exam": "d4daf49c80cb4e548b9711720c319bcb",
"score": 20
}
}失败信息:
| status | msg |
|---|---|
| -1 | 提交失败 |
| -2 | 用户未登录 |
| -2 | 未参加学习 |
| -4 | 考试不存在 |
| -4 | 课程不存在 |
| -4 | 不在考试时间 |
| -4 | 不可重复提交 |
URL:39.107.102.246/exam/final/score/{考试ID}
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "暂无成绩"
}{
"status": 0,
"msg": "查询成功",
"data": {
"exam": "d4daf49c80cb4e548b9711720c319bcb",
"score": 20
}
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 未参加学习 |
| -4 | 考试不存在 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/exam/chapter
请求方法:POST
请求参数样例:
{
"chapter":"6c87779f2dcb4588a7fbe3bb42d925b5",
"name":"第一章测试",
"choiceScoreWeight":1,
"choiceList":[
{
"question":"一天有多少小时?",
"optionList":[
"5小时",
"10小时",
"20小时",
"24小时"
],
"answer":"24小时"
},
{
10000
"question":"一小时有多少分钟?",
"score":5,
"optionList":[
"10分钟",
"30分钟",
"60分钟",
"90分钟"
],
"answer":"60分钟"
}
],
"judgementScoreWeight":1,
"judgementList":[
{
"question":"青岛工学院是双一流大学.",
"score":5,
"answer":"false"
},
{
"question":"BTA指的是百度,腾讯和阿里爸爸.",
"score":5,
"answer":"true"
}
]
}返回成功样例:
{
"status": 0,
"msg": "创建成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 创建失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
| -4 | 章节不存在 |
| -4 | 有效题目不足 |
URL:http://39.107.102.246/exam/chapter/{考试ID}
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": {
"name": "第一章测试",
"choiceList": [
{
"id": 9,
"question": "一天有多少小时?",
"score": 5,
"optionList": [
"20小时",
"5小时",
"24小时",
"10小时"
]
},
{
"id": 10,
"question": "一小时有多少分钟?",
"score": 5,
"optionList": [
"60分钟",
"10分钟",
"90分钟",
"30分钟"
]
}
],
"judgementList": [
{
"id": 12,
"question": "BTA指的是百度,腾讯和阿里爸爸.",
"score": 5
},
{
"id": 11,
"question": "青岛工学院是双一流大学.",
"score": 5
}
]
}
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 未参加学习 |
| -4 | 考试不存在 |
| -4 | 课程不存在 |
| -4 | 章节不存在 |
URL:http://39.107.102.246/exam/final/{考试ID}
请求方法:POST
请求参数样例:
{
"choiceList":[
{
"id":1,
"answer":"24小时"
},
{
"id":2,
"answer":"60分钟"
}
],
"judgementList":[
{
"id":3,
"answer":false
},
{
"id":4,
"answer":true
}
]
}返回成功样例:
{
"status": 0,
"msg": "提交成功",
"data": {
"exam": "0ae6c94c1e1f4507832405d50ff065b0",
"score": 20
}
}失败信息:
| status | msg |
|---|---|
| -1 | 提交失败 |
| -2 | 用户未登录 |
| -2 | 未参加学习 |
| -4 | 考试不存在 |
| -4 | 课程不存在 |
| -4 | 章节不存在 |
URL:39.107.102.246/exam/chapter/score/{考试ID}
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": {
"exam": "0ae6c94c1e1f4507832405d50ff065b0",
"score": 20
}
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -2 | 未参加学习 |
| -4 | 考试不存在 |
| -4 | 课程不存在 |
| -4 | 章节不存在 |
URL:http://39.107.102.246/upload/course/image
请求方法:POST(multipart/form-data)
请求参数样例:
| 参数名 | 参数类型 | 参数值 |
|---|---|---|
| course | text | 81f88387543743328b30d7b299f33c01 |
| image | file | image.jpg |
| 返回成功样例: |
{
"status": 0,
"msg": "上传成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 上传失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
| -4 | 不支持的文件类型 |
URL:http://39.107.102.246/upload/chapter/video
请求方法:POST(multipart/form-data)
请求参数样例:
| 参数名 | 参数类型 | 参数值 |
|---|---|---|
| chapter | text | 81f88387543743328b30d7b299f33c01 |
| video | file | video.mp4 |
| 返回成功样例: |
{
"status": 0,
"msg": "上传成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 上传失败 |
| -2 | 用户未登录 |
| -2 | 权限不足 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |
| -4 | 章节不存在 |
| -4 | 不支持的文件类型 |
URL:http://39.107.102.246/files/info
请求方法:GET
请求参数样例:?file=0478f16dfa5946a887ecb3b6610d8074
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": {
"id": "0478f16dfa5946a887ecb3b6610d8074",
"mappingPath": "/files/image/course/81f88387543743328b30d7b299f33c01/",
"realName": "程序员",
"suffix": "png"
}
}失败信息:
| status | msg |
|---|---|
| -3 | 缺少参数 |
| -4 | 文件不存在 |
URL:http://39.107.102.246{文件mappingPath}{文件ID}.{文件后缀名}
请求方法:GET
请求参数样例:无
返回成功样例:文件资源
失败信息:无
URL:http://39.107.102.246/student/course/list
请求方式:GET
请求参数样例:无
成功返回样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "81f88387543743328b30d7b299f33c01",
"name": "API开发",
"image": "0478f16dfa5946a887ecb3b6610d8074",
"teacher": "李老师",
"tag": "web;API;开发",
"finalExam": "a0f94e7f7e9945738f3e7e52d665a1db"
}
]
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
URL:http://39.107.102.246/student/course/spinner
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "81f88387543743328b30d7b299f33c01",
"name": "API开发"
}
]
}失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
URL:http://39.107.102.246/student/course/{课程ID}
请求参数:POST
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "选课成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 选课失败 |
| -1 | 已经参加该课程 |
| -2 | 用户未登录 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/student/course/{课程ID}
请求参数:DELETE
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "退课成功"
}失败信息:
| status | msg |
|---|---|
| -1 | 退课失败 |
| -1 | 未参加该课程 |
| -2 | 用户未登录 |
| -4 | 课程不存在 |
URL:http://39.107.102.246/spinner/course
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "1",
"name": "111"
},
{
"id": "81f88387543743328b30d7b299f33c01",
"name": "API开发"
},
{
"id": "096702b7aab44441815622f4788df63b",
"name": "API开发"
}
]
}失败信息:无
URL:http://39.107.102.246/spinner/chapter
请求方法:GET
请求参数样例:?course=81f88387543743328b30d7b299f33c01
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "6c87779f2dcb4588a7fbe3bb42d925b5",
"num": 1,
"name": "API第一课"
}
]
}失败信息:
| status | msg |
|---|---|
| -3 | 缺少参数 |
URL:http://39.107.102.246/spinner/exam
请求方法:GET
请求参数样例:?course=81f88387543743328b30d7b299f33c01
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "6c87779f2dcb4588a7fbe3bb42d925b5",
"num": 1,
"name": "API第一课"
}
]
}失败信息:
| status | msg |
|---|---|
| -3 | 缺少参数 |
URL:http://39.107.102.246/course/tag/{标签名}
请求方法:GET
请求参数样例:无
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "81f88387543743328b30d7b299f33c01",
"name": "API开发",
"image": "0478f16dfa5946a887ecb3b6610d8074",
"teacher": "李老师",
"tag": "web;API;开发",
"finalExam": "a0f94e7f7e9945738f3e7e52d665a1db"
},
{
"id": "096702b7aab44441815622f4788df63b",
"name": "API开发",
"image": null,
"teacher": "李老师",
"tag": "web;API;开发",
"finalExam": null
}
]
}失败信息:无
URL:http://39.107.102.246/ccourse/chapter/list
请求方法:GET
请求参数样例:?course=81f88387543743328b30d7b299f33c01
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": {
"chapterList": [
{
"id": "6c87779f2dcb4588a7fbe3bb42d925b5",
"num": 1,
"name": "API第一课",
"info": "API第一课",
"video": "71143e27752c41059e852e7aa004c029",
"chapterExam": "6e02e9532a1f419bb834397fbf845e0a"
}
],
"finalExam": "a0f94e7f7e9945738f3e7e52d665a1db"
}
}失败信息:
| status | msg |
|---|---|
| -3 | 缺少参数 |
| -4 | 课程不存在 |
| -4 | 未参加学习 |
URL:http://39.107.102.246/course/notice
请求方法:GET
请求参数样例:?course=81f88387543743328b30d7b299f33c01
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"content": "公告",
"createTime": "2019-04-22 22:18:20"
}
]
}错误信息:无
URL:http://39.107.102.246/rotationPicture/list
请求方法:Get
请求参数样例:?tag=index
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": [
{
"id": "rotation1",
"mappingPath": "/files/image/rotation/",
"realName": "rotation_picture_1",
"suffix": "jpg"
},
{
"id": "rotation2",
"mappingPath": "/files/image/rotation/",
"realName": "rotation_picture_2",
"suffix": "jpg"
},
{
"id": "rotation3",
"mappingPath": "/files/image/rotation/",
"realName": "rotation_picture_3",
"suffix": "jpg"
}
]
}失败信息:无
URL:http://39.107.102.246/course/isStudent
请求方法:GET
请求参数样例:?course=81f88387543743328b30d7b299f33c01
返回成功样例:
{
"status": 0,
"msg": "查询成功",
"data": {
"isStudent": true
}
}
//成功情况包括参加课程的学生和该课程的教师失败信息:
| status | msg |
|---|---|
| -2 | 用户未登录 |
| -3 | 缺少参数 |
| -4 | 课程不存在 |