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": 19,  //学科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": 19,
                "name": "数学",  //学科名称
                "level": 1,  //年级
                "levelName": "一年级"  //年级名称
            }
        ]
    }
}

4.3.11 学科查询

  • 接口地址:/api/admin/education/subject/select/2
  • 请求参数:无
  • 返回参数:
{
    "code": 1,
    "message": "成功",
    "response": {
        "id": 19,
        "name": "数学",  //学科名称
        "level": 1,    //年级
        "levelName": "一年级"   //年级名称
    }
}

4.3.12 学科编辑

  • 接口地址:/api/admin/education/subject/edit
  • 请求参数:
{
    "id": 19,
    "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": 19,     //试卷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": 19,   //试卷id
        "level": 1,  //年级
        "subjectId": 1,  //学科
        "paperType": 1,  //试卷类型
        "name": "语文试卷", //试卷名称  
        "suggestTime": 20,  //考试时间
        "limitDateTime": null,  //限时考试
        "titleItems": [
            {
                "name": "一、选择题",  //试卷标题
                "questionItems": [
                    {
                        "id": 19,   //题目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": 19,  //试卷id
    "level": 1,  //年级
    "subjectId": 1,  //学科
    "paperType": 6,  //试卷类型
    "name": "中级任务二",  //试卷名称
    "suggestTime": 20,  //考试时长
    "limitDateTime": null,  //限时
    "titleItems": [
        {
            "name": "一、选择题",  //标题
            "questionItems": [   //题目列表
                {
                    "id": 19,   //题目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": 19,  //试卷id
        "level": 1,  //年级
        "subjectId": 1,   //学科
        "paperType": 6,   //试卷类型
        "name": "中级任务二",   //试卷名称
        "suggestTime": 20,  //考试时长
        "limitDateTime": null,  //限时
        "titleItems": [
            {
                "name": "一、选择题",  //标题
                "questionItems": [
                    {
                        "id": 19,   //题目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": 19,
                "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": 19,
                "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": 19, //题目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": 19,   //任务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": 19,  //任务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": 19,
    "gradeLevel": 1,
    "title": "中级任务",
    "paperItems": [
        {
            "id": 19,  //试卷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": 19,  //任务id
        "gradeLevel": 1,   //年级
        "title": "中级任务",  //任务标题
        "paperItems": [
            {
                "id": 19,  //试卷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": 19,   //消息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": 19,
                "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": 19,  //日志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": 19,
        "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": 19,  //用户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
  • 请求参数:
student  //用户名
  • 返回参数:
{
    "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": 19,
    "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
}
Last Updated:
Contributors: mindskip, 思维跳跃科技