4.3 管理端
4.3.1 登录
- 接口地址：/api/user/login
- 请求参数：
{
"userName": "admin", //用户名
"password": "", //密码
"remember": false //记住我
}
{
"code": 1,
"message": "成功",
"response": {
"id": null,
"userUuid": null,
"userName": "admin", //用户名
"password": null,
"realName": null,
"age": null,
"sex": null,
"birthDay": null,
"userLevel": null,
"phone": null,
"role": null,
"status": null,
"imagePath": null,
"createTime": null,
"modifyTime": null,
"lastActiveTime": null,
"deleted": null,
"wxOpenId": null
}
}
4.3.2 登出
- 接口地址：/api/user/logout
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": null
}
4.3.3 首页
- 接口地址：/api/admin/dashboard/index
- 请求参数：无
- 返回参数：
{
"examPaperCount": 2413, //试卷总数
"questionCount": 1025, //题目总数
"doExamPaperCount": 6148, //总答卷数
"doQuestionCount": 23945, //总题数
"mothDayUserActionValue": [ //活跃度
85
],
"mothDayDoExamQuestionValue": [ //月做题数
22
],
"mothDayText": [ //本月天数
"1"
]
}
4.3.4 用户分页
- 接口地址：/api/admin/user/page/list
- 请求参数：
{
"userName": "", //用户名
"role": 1, //角色
"pageIndex": 1, //页码
"pageSize": 10 //每页条数
}
{
"code": 1,
"message": "成功",
"response": {
"total": 81, //总数
"list": [
{
"id": 100, //用户id
"userUuid": "fd31ab62-c32f-433c-8dc4-c07e653d390a", //用户uuid
"userName": "王", //用户名
"realName": null, //真实姓名
"age": null, //年龄
"role": 1, //角色
"sex": null, //性别
"birthDay": "", //出生日期
"phone": null, //手机号
"lastActiveTime": "2021-06-21 20:01:26", //最后活动时间
"createTime": "2021-06-21 20:01:26", //创建时间
"modifyTime": "2021-06-21 20:01:35", //修改时间
"status": 1, //状态
"userLevel": 1, //年级
"imagePath": null //头像
}
]
}
}
4.3.5 用户查询
- 接口地址：/api/admin/user/select/1
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": {
"id": 100, //用户id
"userUuid": "fd31ab62-c32f-433c-8dc4-c07e653d390a", //用户uuid
"userName": "王", //用户名
"realName": null, //真实姓名
"age": null, //年龄
"role": 1, //角色
"sex": null, //性别
"birthDay": "", //出生日期
"phone": null, //手机号
"lastActiveTime": "2021-06-21 20:01:26", //最后活动时间
"createTime": "2021-06-21 20:01:26", //创建时间
"modifyTime": "2021-06-21 20:01:35", //修改时间
"status": 1, //状态
"userLevel": 1, //年级
"imagePath": null //头像
}
}
4.3.6 用户编辑
- 接口地址：/api/admin/user/edit
- 请求参数：
{
"id": null,
"userName": "testzz", //用户名
"password": "123456", //密码
"realName": "tesx", //真实姓名
"role": 1, //角色
"status": 1, //状态
"age": "", //年龄
"sex": "", //性别
"birthDay": null, //生日
"phone": null, //手机号
"userLevel": 1 //年级
}
{
"code": 1,
"message": "成功",
"response": {
"id": 109,
"userUuid": "321dec89-0656-4736-ae4c-e2b07f4fcc67", //用户id
"userName": "testzz", //用户名
"password": "" //密码
"realName": "tesx", //真实姓名
"age": null, //年龄
"sex": null, //性别
"birthDay": null, //生日
"userLevel": 1, //年级
"phone": null, //手机号
"role": 1, //角色
"status": 1, //状态
"imagePath": null, //头像
"createTime": 1624538837259, //创建日期
"modifyTime": null, //修改时间
"lastActiveTime": 1624538837259, //最后活动时间
"deleted": false, //是否删除
"wxOpenId": null //微信openId
}
}
4.3.7 用户删除
- 接口地址：/api/admin/user/delete/3
- 请求参数：无
- 返回参数：
{
"code": 1, //返回状态
"message": "成功", //返回消息
"response": null
}
4.3.8 用户状态修改
- 接口地址：/api/admin/user/changeStatus/1
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": 2
}
4.3.9 学科列表
- 接口地址：/api/admin/education/subject/list
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": [
{
"id": 24, //学科id
"name": "语文", //学科名称
"level": 1, //年级
"levelName": "一年级", //年级名称
"itemOrder": null, //排序
"deleted": false //是否删除
}
]
}
4.3.10 学科分页
- 接口地址：/api/admin/education/subject/page
- 请求参数：
{
"level": null, //年级
"pageIndex": 1,
"pageSize": 10
}
{
"code": 1,
"message": "成功",
"response": {
"total": 2,
"list": [
{
"id": 24,
"name": "数学", //学科名称
"level": 1, //年级
"levelName": "一年级" //年级名称
}
]
}
}
4.3.11 学科查询
- 接口地址：/api/admin/education/subject/select/2
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": {
"id": 24,
"name": "数学", //学科名称
"level": 1, //年级
"levelName": "一年级" //年级名称
}
}
4.3.12 学科编辑
- 接口地址：/api/admin/education/subject/edit
- 请求参数：
{
"id": 24,
"name": "数学", //学科名称
"level": 2, //年级
"levelName": "二年级" //年级名称
}
{
"code": 1,
"message": "成功",
"response": null
}
4.3.13 学科删除
- 接口地址：/api/admin/education/subject/delete/3
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": null
}
4.3.14 试卷分页
- 接口地址：/api/admin/exam/paper/page
- 请求参数：
{
"id": null,
"level": null, //年级
"subjectId": null, //学科
"pageIndex": 1, //页码
"pageSize": 10 //每页数量
}
{
"code": 1,
"message": "成功",
"response": {
"total": 9,
"list": [
{
"id": 24, //试卷id
"name": "中级任务二", //试卷名称
"questionCount": 5, //题目总数
"score": 180, //试卷分数
"createTime": "2021-01-21 11:49:31", //创建时间
"createUser": 2, //创建人
"subjectId": 1, //学科
"paperType": 6, //试卷类型
"frameTextContentId": 13 //试卷内容
}
]
}
}
4.3.15 试卷查询
- 接口地址：/api/admin/exam/paper/select/9
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": {
"id": 24, //试卷id
"level": 1, //年级
"subjectId": 1, //学科
"paperType": 1, //试卷类型
"name": "语文试卷", //试卷名称
"suggestTime": 20, //考试时间
"limitDateTime": null, //限时考试
"titleItems": [
{
"name": "一、选择题", //试卷标题
"questionItems": [
{
"id": 24, //题目id
"questionType": 5, //题目类型
"subjectId": 1, //学科
"title": "默写咏鹅", //题干
"gradeLevel": 1, //年级
"items": [], //题目选项
"analyze": "咏鹅可以带拼音", //解析
"correctArray": null, //标答数组
"correct": "鹅鹅鹅， 曲项向天歌。 白毛浮绿水， 红掌拨清波。", //标答
"score": "10", //题目分数
"difficult": 3, //难度
"itemOrder": 1 //题序
}
]
}
],
"score": "10" //试卷总分
}
}
4.3.16 试卷编辑
- 接口地址：/api/admin/exam/paper/edit
- 请求参数：
{
"id": 24, //试卷id
"level": 1, //年级
"subjectId": 1, //学科
"paperType": 6, //试卷类型
"name": "中级任务二", //试卷名称
"suggestTime": 20, //考试时长
"limitDateTime": null, //限时
"titleItems": [
{
"name": "一、选择题", //标题
"questionItems": [ //题目列表
{
"id": 24, //题目id
"questionType": 2, //题型
"subjectId": 1, //学科
"title": "以下哪些诗句是静夜思的？", //题干
"gradeLevel": 1, //年级
"items": [ //选项
{
"prefix": "A", //选项标记
"content": "床前明月光", //选项内容
"score": null, //选项分数
"itemUuid": null //选项标识
}
],
"analyze": "床前明月光， 疑是地上霜。 举头望明月， 低头思故乡。", //解析
"correctArray": [ //正确答案
"A",
"C"
],
"correct": "A,C", //正确答案
"score": "0", //题目分数
"difficult": 3, //难度
"itemOrder": 1 //题序
}
]
}
],
"score": "18" //试卷总分
}
{
"code": 1,
"message": "成功",
"response": {
"id": 24, //试卷id
"level": 1, //年级
"subjectId": 1, //学科
"paperType": 6, //试卷类型
"name": "中级任务二", //试卷名称
"suggestTime": 20, //考试时长
"limitDateTime": null, //限时
"titleItems": [
{
"name": "一、选择题", //标题
"questionItems": [
{
"id": 24, //题目id
"questionType": 2, //题型
"subjectId": 1, //学科
"title": "以下哪些诗句是静夜思的？", //题干
"gradeLevel": 1, //年级
"items": [ //选项
{
"prefix": "A", //选项标记
"content": "床前明月光", //选项内容
"score": null, //选项分数
"itemUuid": null //选项标识
}
],
"analyze": "床前明月光， 疑是地上霜。 举头望明月， 低头思故乡。", //解析
"correctArray": [ //正确答案
"A",
"C"
],
"correct": "A,C", //正确答案
"score": "0", //题目分数
"difficult": 3, //难度
"itemOrder": 1 //题序
}
]
}
],
"score": "18" //题序
}
}
4.3.17 试卷删除
- 接口地址：/api/admin/exam/paper/delete/9
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": null
}
4.3.18 任务试卷分页
- 接口地址：/api/admin/exam/paper/taskExamPage
- 请求参数：
{
"subjectId": null, //学科
"level": 1, //年级
"paperType": 6, //试卷类型
"pageIndex": 1, //页面
"pageSize": 5
}
{
"code": 1,
"message": "成功",
"response": {
"total": 1,
"list": [
{
"id": 24,
"name": "任务试卷五", //试卷名称
"questionCount": 2, //题目总数
"score": 60, //试卷分数
"createTime": "2021-08-02 14:36:26", //创建时间
"createUser": 2, //创建人
"subjectId": 1, //学科
"paperType": 6, //试卷类型
"frameTextContentId": 26 //试卷内容
}
]
}
}
4.3.19 题目分页
- 接口地址：/api/admin/question/page
- 请求参数：
{
"id": null,
"questionType": null,
"level": null,
"subjectId": null,
"pageIndex": 1,
"pageSize": 10
}
{
"code": 1,
"message": "成功",
"response": {
"total": 7,
"list": [
{
"id": 24,
"questionType": 5, //题型
"textContentId": null,
"createTime": "2021-01-21 11:45:57", //创建时间
"subjectId": 1, //学科
"createUser": 2, //创建人
"score": "10", //得分
"status": 1, //状态
"correct": "鹅鹅鹅， 曲项向天歌。 白毛浮绿水， 红掌拨清波。", //标答
"analyzeTextContentId": null, //解析
"difficult": 3, //难度
"shortTitle": "默写咏鹅" //题干
}
]
}
}
4.3.20 题目查询
- 接口地址：/api/admin/question/select/508
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": {
"id": 508, //题目id
"questionType": 5, //题型
"subjectId": 4, //学科
"title": "<p>什么是快乐星球？</p>", //题干
"gradeLevel": 1, //年级
"items": [], //选项
"analyze": "照抄即可", //解析
"correctArray": null, //标答
"correct": "什么是快乐星球", //正确答案
"score": "5", //题目分数
"difficult": 5, //难度
"itemOrder": null
}
}
4.3.21 题目编辑
- 接口地址：/api/admin/question/edit
- 请求参数：
{
"id": 24, //题目id
"questionType": 5, //题型
"subjectId": 1, //学科
"title": "默写咏鹅", //题干
"gradeLevel": 1, //年级
"items": [], //选项
"analyze": "咏鹅可以带拼音", //解析
"correctArray": null, //标答
"correct": "鹅鹅鹅， 曲项向天歌。 白毛浮绿水， 红掌拨清波。", //正确答案
"score": 10, //题目分数
"difficult": 3, //难度
"itemOrder": null
}
{
"code": 1,
"message": "成功",
"response": null
}
4.3.22 题目删除
- 接口地址：/api/admin/question/delete/7
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": null
}
4.3.23 任务分页
- 接口地址：/api/admin/task/page
- 请求参数：
{
"gradeLevel": null,
"pageIndex": 1,
"pageSize": 10
}
{
"code": 1,
"message": "成功",
"response": {
"total": 2,
"list": [
{
"id": 24, //任务id
"title": "中级任务", //任务标题
"gradeLevel": 1, //年级
"createUserName": "admin", //创建人用户名
"createTime": "2021-01-21 11:50:24", //创建时间
"deleted": false //是否删除
}
]
}
}
4.3.24 任务查询
- 接口地址：/api/admin/task/select/22
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": {
"id": 24, //任务id
"gradeLevel": 12, //年级
"title": "考试", //任务标题
"paperItems": [
{
"id": 592, //试卷id
"name": "考试", //试卷名称
"questionCount": 5, //题目数量
"score": 275, //试卷分数
"createTime": "2021-08-12 15:02:50", //创建时间
"createUser": 2, //创建人
"subjectId": 46, //学科
"paperType": 6, //试卷类型
"frameTextContentId": 2897, //试卷内容
"allClasses": null
}
]
}
}
4.3.25 任务编辑
- 接口地址：/api/admin/task/edit
- 请求参数：
{
"id": 24,
"gradeLevel": 1,
"title": "中级任务",
"paperItems": [
{
"id": 24, //试卷id
"name": "中级任务一", //试卷名称
"questionCount": 5, //题目数量
"score": 180, //试卷分数
"createTime": "2021-01-21 11:49:11", //创建时间
"createUser": 2, //创建人
"subjectId": 1, //学科
"paperType": 6, //试卷类型
"frameTextContentId": 12 //试卷内容
}
]
}
{
"code": 1,
"message": "成功",
"response": {
"id": 24, //任务id
"gradeLevel": 1, //年级
"title": "中级任务", //任务标题
"paperItems": [
{
"id": 24, //试卷id
"name": "中级任务一", //试卷名称
"questionCount": 5, //题目数量
"score": 180, //试卷分数
"createTime": "2021-01-21 11:49:11", //创建时间
"createUser": 2, //创建人
"subjectId": 1, //学科
"paperType": 6, //试卷类型
"frameTextContentId": 12 //试卷内容
}
]
}
}
4.3.26 任务删除
- 接口地址：/api/admin/task/delete/1
- 请求参数：无
- 返回参数：
{
"code": 1, //返回状态
"message": "成功", //返回消息
"response": null
}
4.3.27 消息分页
- 接口地址：/api/admin/message/page
- 请求参数：
{
"sendUserName": null,
"pageIndex": 4,
"pageSize": 10
}
{
"code": 1,
"message": "成功",
"response": {
"total": 36,
"list": [
{
"id": 24, //消息id
"title": "你好，同学！", //消息标题
"content": "考试请不要作弊", //消息内容
"sendUserName": "admin", //发送人用户名
"receives": "student", //接收人用户名
"receiveUserCount": 1, //接收人数量
"readCount": 1, //已读数量
"createTime": "2020-09-22 11:37:49" //创建时间
}
]
}
}
4.3.28 消息发送
- 接口地址：/api/admin/message/send
- 请求参数：
{
"title": "全校师生请注意", //消息标题
"content": "大家好", //消息内容
"receiveUserIds": [ //接收人
1
]
}
{
"code": 1, //返回状态
"message": "成功", //返回消息
"response": null
}
4.3.29 答卷分页
- 接口地址：/api/admin/examPaperAnswer/page
- 请求参数：
{
"subjectId": null, //学科
"pageIndex": 1,
"pageSize": 10
}
{
"code": 1,
"message": "成功",
"response": {
"total": 4,
"list": [
{
"id": 24,
"createTime": "2021-07-07 14:03:02", //提交时间
"userScore": "16", //用户得分
"subjectName": "语文", //学科名称
"subjectId": 1, //学科Id
"questionCount": 5, //题目数量
"questionCorrect": 4, //正确题目数
"paperScore": "18", //试卷总分
"doTime": "14 秒", //耗时
"paperType": 4, //试卷类型
"systemScore": "2", //自动批改得分
"status": 2, //答卷状态
"paperName": "限时考试二", //试卷名称
"userName": "student" //用户名
}
]
}
}
4.3.30 用户日志
- 接口地址：/api/admin/user/event/page/list
- 请求参数：
{
"userId": null,
"userName": null,
"pageIndex": 1,
"pageSize": 10
}
{
"code": 1,
"message": "成功",
"response": {
"total": 68,
"list": [
{
"id": 24, //日志id
"userId": 2, //用户id
"userName": "admin", //用户名
"realName": "管理员", //真实姓名
"content": "admin 登录了学之思开源考试系统", //日志内容
"createTime": "2021-08-24 20:05:02" //创建时间
}
]
}
}
4.3.31 当前用户信息
- 接口地址：/api/admin/user/current
- 请求参数：无
- 返回参数：
{
"code": 1,
"message": "成功",
"response": {
"id": 24,
"userUuid": "52045f5f-a13f-4ccc-93dd-f7ee8270ad4c", //用户uuid
"userName": "admin", //用户名
"realName": "管理员", //真实姓名
"age": 30, //年龄
"role": 3, //角色
"sex": 1, //性别
"birthDay": "2019-09-07 18:56:07", //出生日期
"phone": null, //手机号
"lastActiveTime": "", //最后活动时间
"createTime": "2019-09-07 18:56:21", //创建时间
"modifyTime": "", //修改时间
"status": 1, //状态
"userLevel": null, //用户年级
"imagePath": null //头像
}
}
4.3.32 用户信息更新
- 接口地址：/api/admin/user/update
- 请求参数：
{
"id": 24, //用户id
"userUuid": "52045f5f-a13f-4ccc-93dd-f7ee8270ad4c", //用户标识
"userName": "admin", //用户名
"realName": "管理员", //真实姓名
"age": 30, //年龄
"role": 3, //角色
"sex": 1, //性别
"birthDay": "2019-09-07 18:56:07", //生日
"phone": "11", //手机号
"lastActiveTime": "", //最后活动时间
"createTime": "2019-09-07 18:56:21", //创建时间
"modifyTime": "2021-08-17 11:28:52", //修改时间
"status": 1, //状态
"userLevel": null, //年级
"imagePath": null //头像
}
{
"code": 1,
"message": "成功",
"response": null
}
4.3.32 用户信息更新
- 接口地址：/api/admin/user/selectByUserName
- 请求参数：
{
"code": 1,
"message": "成功",
"response": [
{
"name": "student", //用户名
"value": 1 //用户id
}
]
}
4.3.33 图片上传
- 接口地址：/api/admin/upload/configAndUpload
- 请求参数：无
- 返回参数：
{
"original": "头像.jpg",
"name": "头像.jpg",
"url": "http://xzs.file.mindskip.net/Fi4vlEf1ri4VMGSONwN2Ch0o8Ed_",
"size": 19665,
"type": ".jpg",
"state": "SUCCESS"
}
4.3.34 个人信息修改
- 接口地址：/api/admin/user/update
- 请求参数：
{
"id": 24,
"userUuid": "52045f5f-a13f-4ccc-93dd-f7ee8270ad4c", //用户uuid
"userName": "admin", //用户名
"realName": "管理员", //真实姓名
"age": 30, //年龄
"role": 3, //角色
"sex": 1, //性别
"birthDay": "2021-09-07 18:56:07", //出生日期
"phone": "2112112", //手机号
"lastActiveTime": "", //最后活动时间
"createTime": "2019-09-07 18:56:21", //创建时间
"modifyTime": "2021-08-31 10:08:03", //修改时间
"status": 1, //状态
"userLevel": null, //年级
"imagePath": null //头像
}
{
"code": 1,
"message": "成功",
"response": null
}
