美文网首页
考试系统Wap端Api接口文档

考试系统Wap端Api接口文档

作者: 河嘿嘿 | 来源:发表于2017-08-21 15:33 被阅读0次

本接口采用Session方式登录，sessionId的优先级 （POST/GET）请求的参数中token字段 > COOKIES中的token >COOKIES中的默认sessionId，支持COOKIE直接调用登录接口返回成功后即可使用其他接口，不支持则需调用非登陆接口时在参数上加token参数。

#返回格式为JSON格式，通用规则请看下列示例的注释
{
  "code":200,//接口返回验证码，只有200为操作成功，401为需要验证登录，
  "message":"提示信息"，
  "data":[//接口返回前台所需的数据
    {
      "name":"asss"
    }
  ]
}

1.1 登录

地址：Wap/Login/loginById
请求方式：POST

#请求参数
user_id #账号
user_password #密码

#成功返回
{
  "code":200,
  "message":"success",
  "data":{
    "token"
    "no":"1",
    "user_id":"liuxin",
    "role_no":"01",
    "college_id":"%",
    "college_name":"\u5b66\u6821",
    "campus_name":null,
    "numrow":"1",
    "cn_role":"\u7cfb\u7edf\u7ba1\u7406\u5458(\u5b66\u6821)",
    "is_manage":"1",
    "is_teacher":"1",
    "sort":0,
    "token": "skdabi47vgfkpsiu3298oibsj5"
  }
}

#失败返回
{
  "code": 500,
  "message": "fail_param",
  "data": "密码错误"
}

1.2 注销

地址：Wap/Login/logout
请求方式：GET

#请求参数
无

#成功返回
{
  "code": 200,
  "message": "登出成功",
}
#失败返回
无失败情况

2.1 账号信息

地址：Wap/User/getLoginInfo
请求方式：GET

#请求参数
无

#成功返回
{
    "code": 200,
    "message": "OK",
    "data": {
        "user_id": "liuxin",
        "user_name": "刘欣",//姓名
        "campus_id": "01",
        "college_id": "01",//学院ID
        "major_id": null,//专业ID
        "grade_id": null,//年级ID
        "length_school": null,//学制年份
        "manager_mark": "1",
        "teacher_mark": "1",
        "usertype_id": null,//学生身份ID（本科、研究生、博士）
        "campus_name": "净月校区",//校区
        "college_name": null,//学院名称
        "major_name": null,//专业名称
        "usertype_name": null,//学生身份（本科、研究生、博士）
        "numrow": "1",
        "privilegeArray": [//拥有的角色
            {
                "role_no": "03",
                "user_id": "liuxin",
                "college_id": "01",
                "college_name": null,
                "major_id": null,
                "grade_id": null,
                "cn_role": "教职工",//角色名称
                "is_manage": "0",
                "is_teacher": "1",
                "sort": 0
            }
        ],
        "currentrole": {//当前的角色
            "role_no": "03",
            "user_id": "liuxin",
            "college_id": "01",
            "college_name": null,
            "major_id": null,
            "grade_id": null,
            "cn_role": "教职工",//角色名称
            "is_manage": "0",
            "is_teacher": "1",
            "sort": 0
        }
    }
}

#失败返回
{
    "code":401,
    "message":"need login"
}

2.2 修改密码

地址：Wap/User/changePass
请求方式：POST

#请求参数
old_pass #原密码
new_pass #新密码
confirm_pass #确认密码

#成功返回
{
    "code":200,
    "message":"success"
}

#失败返回
{
    "code":400,
    "message":"fail_param",
    "data":"原密码错误"
}

3.1 轮播图

地址：Wap/Picture/indexBanner
请求方式：GET

#请求参数
无

#成功返回
{
    "code": 200,
    "message": "SUCCESS",
    "data": [
        {
            "title": "测试1",
            "picture_url": "https://dss3.baidu.com/-rVXeDTa2gU2pMbgoY3K/it/u=1454919540,2813015134&fm=202&mola=new&crop=v1",
            "redirect_url": "https://www.baidu.com",
            "redirect_type": "web"//跳转类型（web,route）
        },
        {
            "title": "测试2",
            "picture_url": "https://www.kubernetes.org.cn/img/2018/11/k8s02-1200.jpg",
            "redirect_url": "https://www.kubernetes.org.cn/doc-5",
            "redirect_type": "web"//跳转类型（web,route）
        }
    ]
}

#失败返回
{
    "code":400,
    "message":"fail_param",
    "data":"原密码错误" 
}

3.2 新闻列表

地址：Wap/Article/items
请求方式：GET

#请求参数
key #标题（模糊匹配）
start #起始行数
limit #当前页最大行数
release_type_id #文章分类 
                #01通知公告 
                #02新闻中心 
                #11国家政策法规 
                #22学校管理制度 
                #33规范性文件 
                #44安全标准
#成功返回
{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "release_no": "334",//文章编号
                "title": "教育部办公厅关于进一步加强高校教学实验室 安全检查工作的通知",//标题
                "user_id": "19940011",
                "college_id": "%",
                "v_establish_date": "2019-03-20",
                "v_release_date": "2019-03-20",//发布时间
                "release_type_id": "11",
                "top_mark": "否",//置顶
                "frequency": "6",//点击量
                "numrow": "1"
            },
            {
                "release_no": "320",
                "title": "《2018年高等学校实验室安全检查项目表》 条款分级及检查结果分级方案",
                "user_id": "19940011",
                "college_id": "%",
                "release_date": "30-OCT-18",
                "v_establish_date": "2018-10-30",
                "v_release_date": "2018-10-30",
                "release_type_id": "11",
                "release_mark": "1",
                "top_mark": "0",
                "frequency": "4",
                "numrow": "2"
            }
        ],
        "total": "6"
    }
}

#失败返回
{
    "code":400,
    "message":"系统错误",
}

3.3 新闻详情

地址：Wap/Article/item
请求方式：GET

#请求参数
release_no #文章编号

#成功返回
{
    "code": 200,
    "message": "success",
    "data": {
        "release_no": "332",
        "title": "关于开展2018年度实验室安全检查的通知",//标题
        "user_id": "20120048",
        "college_id": "%",
        "release_date": "20-MAR-19",
        "v_establish_date": "2019-03-20",
        "v_release_date": "2019-03-20",//发布日期
        "release_type_id": "01",
        "release_mark": "是",
        "top_mark": "否",//置顶
        "frequency": "19",//点击量
        "numrow": "1",
        "v_release_type": "通知公告",//文章分类
        "content": "<p>各有关单位：</p><p>为进一步加强学校实验室安全管理：</p>......."//内容
    }
}
#失败返回
{
    "code":500,
    "message":"文章不存在或已被删除",
}

4.1 获取题型

地址：Wap/Question/getQuestionType
请求方式：GET

#请求参数
无

#成功返回
{
    "code": 200,
    "message": "SUCCESS",
    "data": {
        "01": "单选题",
        "02": "多选题",
        "03": "判断题"
    }
}
#失败返回
{
    "code":401,
    "message":"need login",
}

4.2 获取知识点

地址：Wap/Question/getKnowledgePoint
请求方式：GET

#请求参数
无

#成功返回
{
    "code": 200,
    "message": "SUCCESS",
    "data": [
        {
            "knowledge_point_id": "69",//知识点ID
            "knowledge_point": "机械建筑",//知识点
            "college_id": "%",
            "college_name": "学校",
            "numrow": "1",
            "icon": "https://dss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/u=4012764803,2714809145&fm=26&gp=0.jpg"//ICON图标
        },
        {
            "knowledge_point_id": "70",
            "knowledge_point": "生物医学及生物安全",
            "college_id": "%",
            "college_name": "学校",
            "numrow": "2",
            "icon": "https://ss0.bdstatic.com/94oJfD_bAAcT8t7mm9GUKT-xh_/timg?image&quality=100&size=b4000_4000&sec=1582095675&di=2d1140c9f4dbf6e56bffe7c6263d0c67&src=http://pic1.16pic.com/00/51/76/16pic_5176356_b.jpg"
        }
    ]
}
#失败返回
{
    "code":401,
    "message":"need login",
}

4.3 获取在线学习习题详情

地址：Wap/Question/getQuestion
请求方式：GET

#请求参数
knowledge_point_id #知识点ID
question_type_id #题型ID
numrow #题目序号（不传则默认第1题）

#单选题成功返回
{
    "code": 200,
    "message": "SUCCESS",
    "data": {
        "detail": {
            "question_no": "204578",
            "question_stem": "对人和环境有中度潜在危险的病原微生物一般不引起气溶胶传播的微生物应该在（）实验室中进行操作。",//题干
            "v_establish_date": "2018-09-04",
            "professional_level_id": "01",
            "professional_level": "通识类",//专业等级名称
            "knowledge_point_id": "70",
            "knowledge_point": "生物医学及生物安全",//知识点名称
            "question_type_id": "01",
            "question_type": "单选题",//题型名称
            "user_id": null,
            "user_name": null,
            "q_college": "学校",
            "q_college_id": "%",
            "numrow": "2",//当前题目序号（一定好以返回的序号为准，因为传参的题目序号不一定和当前序号相等）
            "analysis": "",//解析
            "right_choice": "272927",//正确答案
            "choice": {//选项  选项ID：选项内容
                "272926": "生物安全1级（BSL-2）",
                "272927": "生物安全2级（BSL-3）",
                "272928": "生物安全3级（BSL-4）",
                "272929": "生物安全4级（BSL-5）"
            }
        },
        "total_numrow": "300"//习目个数
    }
}

#多选题成功返回
{
    "code": 200,
    "message": "SUCCESS",
    "data": {
        "detail": {
            "question_no": "210422",
            "question_stem": "使用生物安全柜时下列哪种操作是正确的？（）",//题干
            "v_establish_date": "2018-09-04",
            "professional_level_id": "01",
            "professional_level": "通识类",//专业等级名称
            "knowledge_point_id": "70",
            "knowledge_point": "生物医学及生物安全",//知识点名称
            "question_type_id": "02",
            "question_type": "多选题",//题型名称
            "user_id": null,
            "user_name": null,
            "q_college": "学校",
            "q_college_id": "%",
            "numrow": "2",//当前题目序号（一定好以返回的序号为准，因为传参的题目序号不一定和当前序号相等）
            "right_choice": [//正确答案
                "286856",
                "286857",
                "286858"
            ],
            "analysis": "",//解析
            "choice": {//选项  选项ID：选项内容
                "286856": "在工作完成或一天结束时，应当对BSC的表面进行消毒。",
                "286857": "在开始工作前和工作结束后都应当让BSC的风扇运行5分钟。",
                "286858": "操作者应当尽量减少胳膊的伸进和移出。",
                "286859": "不能用移液管或其他物质堵住工作区前面的空气格栅。"
            }
        },
        "total_numrow": "61"//习目个数
    }
}

#判断题成功返回
{
    "code": 200,
    "message": "SUCCESS",
    "data": {
        "detail": {
            "question_no": "207528",
            "question_stem": "62在遗传学等实验中接触的秋水仙素是致癌物质，实验中可以让少量药品接触到皮肤上。",//题干
            "v_establish_date": "2018-09-04",
            "professional_level_id": "01",
            "professional_level": "通识类",//专业等级
            "knowledge_point_id": "70",
            "knowledge_point": "生物医学及生物安全",//知识点
            "question_type_id": "03",
            "question_type": "判断题",//题型
            "user_id": null,
            "user_name": null,
            "q_college": "学校",
            "q_college_id": "%",
            "numrow": "2",//当前题目序号（一定好以返回的序号为准，因为传参的题目序号不一定和当前序号相等）
            "right_wrong_mark": "0",//答案 0错误 1正确
            "analysis": ""//解析
        },
        "total_numrow": "609"//习题个数
    }
}

#错误返回
{
    "code": 404,
    "message": "没有更多习题了哦！"
}

5.1 获取考试信息列表

地址：Wap/Exam/getExamList
请求方式：GET

#请求参数
status_id #考试状态ID
examination_no #查询的指定考试编号的信息

#成功数据返回
{
    "code": 200,
    "message": "success",
    "data": {
        "total": "1",//考试总数
        "list": [
            {
                "examination_no": "416",//考试编号
                "examination_name": "测试考试",//考试标题
                "notice": "<p>测试</p>",//考试通知
                "preface": "<p>测试</p>",//前言通知
                "publish_college_id": "%",//发布考试学院ID
                "publish_college_name": "学校",//发布考试学院
                "start_time": "20/02/24 18:53",//考试开始时间
                "end_time": "20/02/25 18:53",//考试结束时间
                "max_frequency": "2",//最大答题次数
                "status_id": "1",//考试状态ID 0尚未开始 1考试中 2考试过期
                "total_score": "100",//总分
                "pass_score": "90",//通过分数
                "answer_time": "60",//答题时间（分钟）
                "my_max_score": "90",//我的最高得分
                "numrow": "1",
                "exam_status_cn": "考试中",//考试状态
                "part_times": "2",//参加次数
                "can_part": false,//是否能参加本次考试
                "can_print_cert": true//是否能打印证书
            }
        ]
    }
}
#空数据返回
{
    "code": 200,
    "message": "success",
    "data": {
        "total": "1",
        "list": []
    }
}
#错误返回
{
    "code": 200,
    "message": "系统错误"
}

5.2 开始考试（获取试卷数据）

地址：Wap/Exam/getExamPaper
请求方式：GET

#请求参数
examination_no #考试编号

#成功返回
{
    "code": 200,
    "message": "success",
    "data": {
        "exam": {
            "examination_no": "416",//考试编号
            "examination_name": "测试考试",//考试名称
            "notice": "<p>测试</p>",
            "preface": "<p>测试</p>",
            "publish_college_id": "%",
            "publish_college_name": "学校",//考试发布学院
            "start_time": "20/02/24 18:53",//考试开始时间
            "end_time": "20/02/25 18:53",//考试结束之间
            "max_frequency": "3",//最大答题次数
            "status_id": "1",//考试状态ID
            "paper_no": "1059",
            "is_random": "0",
            "total_score": "100",//总分
            "pass_score": "90",通过分数
            "answer_time": "60",//答题时间（分钟）
            "my_max_score": "90",//当前考生的最高分
            "numrow": "1",
            "exam_status_cn": "考试中",//开始状态
            "part_times": "1",//参加考试次数
            "can_part": true,
            "can_print_cert": false,
            "begin_timestamp": 1582624796//确认时间（点击确认了才有此字段，有此字段时开始答题时间按此数值计算且不需要再次弹出确认框）
        },
        "paper": [
            {
                "question_no": "204232",//考题编号
                "list_no": "12740",
                "professional_level_id": "01",
                "professional_level": "通识类",
                "knowledge_point_id": "71",
                "knowledge_point": "实验室安全",
                "question_type_id": "01",
                "question_type": "单选题",//题目类型
                "question_stem": "师生进入生化实验室工作，一定要搞清楚等位置，出现情况能做好相应的自救工作。",//题干
                "question_score": "30",//此题分数
                "choice": {
                    "282085": "ZWICKZ005，50",
                    "282086": "ZWICKZ005，40",
                    "282087": "ZWICKZ020，50",
                    "282088": "无"
                }
            },
            {
                "question_no": "205248",
                "list_no": "12741",
                "professional_level_id": "01",
                "professional_level": "通识类",
                "knowledge_point_id": "71",
                "knowledge_point": "实验室安全",
                "question_type_id": "03",
                "question_type": "判断题",
                "question_stem": "实验室处报告，并采取措施进行整改。对安全隐患隐瞒不报或拖延上报的，学校将对相关责任人进行严肃处理。()",
                "question_score": "40"
            },
            {
                "question_no": "207238",
                "list_no": "12744",
                "professional_level_id": "01",
                "professional_level": "通识类",
                "knowledge_point_id": "71",
                "knowledge_point": "实验室安全",
                "question_type_id": "02",
                "question_type": "多选题",
                "question_stem": "节假日期间，仍然需要进入实验室工作的师生，要严格遵守实验室操作规程，做实验时必须要有人在场，并且在实验完成离开时负责，锁好门窗，以防火灾和爆炸、溢水等事故。（）",
                "question_score": "30",
                "analysis": "",
                "choice": {
                    "123":"无",
                    "124":"关闭计算机",
                    "125":"关闭水源、电源、气源",
                    "126":"关闭实验室安全"
                }
            },
            
        ]
    }
}
#失败返回
{
"code": 400,
"message": "fail_param",
"data": "无法参加本次考试"
}

5.3 确认开始考试

地址：Wap/Exam/makeSureBegin
请求方式：GET

#请求参数
examination_no #考试编号

#确认成功返回
{
    "code": 200,//此状态码考试开始时间按照当前时间开始计时
    "message": "success"
}
#已经确认成功返回
{
    "code": 400,//此状态码需按照data中的时间开始计时
    "message": "你已确认过考试，请继续答题",//提示语
    "data": 1582624796
}
#确认失败返回
{
    "code": 500,//此状态码需弹出提示并退出考试页。
    "message": "fail",
    "data": "考试已过期，请退出重新进入考试！"
}

5.4 提交试卷

地址：Wap/Exam/submitExam
请求方式：POST

#请求参数
examination_no #考试编号
answers #答案，JSON格式，具体规则如下
{  
  "204232":"271968",//单选题："题号":"选项编号"
  "205248":"0", //判断题："题号":"是否正确（1真确 0错误）"
  "204705":["273430","273431","273432"] //多选 ："题号":["选项编号","选项编号","选项编号"]
}

#提交试卷答案成功
{
    "code": 200,
    "message": "success",
    "data": {
        "examination_no": "417",//考试编号
        "information_no": "6639",//答题编号
        "examination_name": "随机试卷测试",//考试名称
        "total_score": "100",//考试总分
        "pass_score": "90",//通过分数
        "answer_time": "60",//考试答题限制时间（分钟）
        "use_time": 700,//本次答题使用时间（秒）
        "current_score": 100,//本次得分
        "can_print_cert": true,//本次考试是否能打印证书
        "pass_mark": 1//本次考试是否通过本次考试
    }
}

5.5 查看答题列表

地址：Wap/Exam/getExamResultList
请求方式：GET

#请求参数
start #起始行数
limit #当前页最大行数
show_pass #是否只显示通过的考试

#成功返回
{
    "code": 200,
    "message": "success",
    "data": {
        "total": "1",
        "list": [
            {
                "information_no": "6636",//答题编号
                "examination_no": "416",//考试编号
                "user_id": "999999",
                "examination_score": "88",//本次答题得分
                "part_start_time": "20/02/26 17:33",//参加本次答题的开始时间
                "part_end_time": "20/02/26 17:33",//参加本次答题的结束时间
                "paper_no": "1059",
                "is_random": "0",
                "user_name": "刘欣",
                "part_user_college_id": "04",
                "major_id": "2321",
                "grade_id": "2018",
                "pass_score": "90",//考试通过分数
                "pass_mark": "0",//是否通过
                "examination_name": "测试考试",//考试名称
                "publish_user_id": "220103198403190411",
                "publish_college_id": "%",
                "exam_college_name": "经济与管理学院",//考员所属学院
                "numrow": "1"
            }
        ]
    }
}

5.6 查看答题详情

地址：Wap/Exam/getExamResultDetail
请求方式：GET

#请求参数
information_no #答题编号
#成功返回
{
    "code": 200,
    "message": "success",
    "data": {
        "information": {//答题基本信息
            "information_no": "6636",//答题编号
            "examination_no": "416",//考试编号
            "user_id": "999999",
            "examination_score": "88",//本次答题所得分数
            "part_start_time": "20/02/26 17:33",
            "part_end_time": "20/02/26 17:33",
            "paper_no": "1059",
            "is_random": "0",
            "user_name": "刘欣",//考生姓名
            "part_user_college_id": "04",
            "major_id": "2321",
            "grade_id": "2018",
            "pass_score": "90",//通过考试所需分数
            "pass_mark": "0",//本次答题是否通过
            "examination_name": "测试考试",//考试名称
            "publish_user_id": "220103198403190411",
            "publish_college_id": "%",
            "exam_college_name": "经济与管理学院",//考生所在学院
            "numrow": "1"
        },
        "paper": [//试卷信息
            {
                "question_no": "204232",
                "list_no": "12740",
                "professional_level_id": "01",
                "professional_level": "通识类",//专业等级
                "knowledge_point_id": "71",
                "knowledge_point": "实验室安全",//所属知识点
                "question_type_id": "01",
                "question_type": "单选题",//题型
                "question_stem": "师生进入生化实验室工作，一定要搞清楚等位置，出现情况能做好相应的自救工作。",//题干
                "question_score": "2",题目分数
                "analysis": "",//解析
                "right_choice": "271967",//正确选项编号
                "choice": { //选项： "选项编号":"选项内容"
                    "271965": "门窗的位置",
                    "271966": "易燃、易爆物品大位置",
                    "271967": "冲眼器、紧急喷淋、急救药箱的位置",
                    "271968": "无"
                },
                "my_score": "0",//本题得分
                "my_choice": "271968"//考生选择的选项编号
            },
            {
                "question_no": "205248",
                "list_no": "12741",
                "professional_level_id": "01",
                "professional_level": "通识类",
                "knowledge_point_id": "71",
                "knowledge_point": "实验室安全",
                "question_type_id": "03",
                "question_type": "判断题",
                "question_stem": "实验室处报告，并采取措施进行整改。对安全隐患隐瞒不报或拖延上报的，学校将对相关责任人进行严肃处理。()",
                "question_score": "2",
                "right_wrong_mark": "1",//本题正确答案
                "analysis": "",//解析
                "my_score": "0",//本题得分
                "my_right_wrong_mark": "0"//我选择的选项
            },
            {
                "question_no": "204632",
                "list_no": "12767",
                "professional_level_id": "01",
                "professional_level": "通识类",
                "knowledge_point_id": "80",
                "knowledge_point": "新生安全",
                "question_type_id": "02",
                "question_type": "多选题",
                "question_stem": "危险化学类品包括哪些种？",
                "question_score": "2",
                "analysis": "",
                "right_choice": [//本题正确选项
                    "273138",
                    "273139",
                    "273140",
                    "273141"
                ],
                "choice": {//选项
                    "273138": "爆炸品易燃气体易爆喷雾剂",
                    "273139": "易燃液体，易燃固体，自反应物质",
                    "273140": "可自燃液体，自燃自热物质，遇水放出易燃气体的物质",
                    "273141": "氧化性液体，氧化性固体，有机过氧化物，金属腐蚀性"
                },
                "my_score": "2",//本题得分
                "my_choice": [//考生选择的选项编号
                    "273138",
                    "273139",
                    "273140",
                    "273141"
                ]
            }
         ]
    }
}

5.7 Pdf证书

地址：Wap/Print
请求方式：GET

#请求参数
examination_no #考试编号

#响应结果与其他接口不同，该接口数据格式为Content-Type →application/pdf

相关文章

网友评论

      本文标题：考试系统Wap端Api接口文档

      本文链接：https://www.haomeiwen.com/subject/dthcdxtx.html

      延伸阅读

      深度阅读

      • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

      栏目导航

      热点阅读

      关于我们|服务条款|联系我们|考试系统Wap端Api接口文档|投稿指南|网站地图|RSS订阅|排版工具|手机版

      提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

      Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

      备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

      本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

      所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！