注: 所有接口只针对企业会员提供,非企业会员无法调用
获取某一学员参与考试的记录
通过该接口,可以获取学员在某一份试卷下的学员成绩。
接口如下所示:
GET https://www.hzxue.com/api/exams/viewresult
参数:
token=权限码&eid=试卷ID&sid=学生ID&start=0&limit=30
参数说明:
- token 每个账户唯一对应的验证码,string类型,该值可联系好智学获取
- eid 表示试卷ID
- sid 表示学员ID, 可选参数,如果该参数为0或没有提供,则会显示参与该试卷考试的所有人员
- start 用于数据量很大时的分页显示,表示分页的数据偏移, 默认为0, 可选参数
- limit 用于数据量很大时的分布显示,设置每页的数据显示数量,默认为30, 可选参数
该接口返回学员在这个试卷里的所有考试记录信息
[ { "viewResult":"https://www.hzxue.com/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接 "score": 30,//考试得分,float类型 "startTime": 1539075728,//学员开始作答的时间戳,int类型,单位s(秒) "endTime": 1539075828,//学员交卷的时间戳,int类型,单位s(秒) "status": 1,//status 表示答卷状态,1表示正常交卷, 0正在考试中,2表示超时自动交卷,3表示被管理员强制交卷,4表示系统执行交卷 }, { "viewResult":"https://www.hzxue.com/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接 "score": 32,//考试得分,float类型 "startTime": 1539075628,//学员开始作答的时间戳,int类型,单位s(秒) "endTime": 1539075828,//学员交卷的时间戳,int类型,单位s(秒) "status": 1,//status 表示答卷状态,1表示正常交卷, 0正在考试中,2表示超时自动交卷,3表示被管理员强制交卷,4表示系统执行交卷 }, ]
获取参与考试的所有考试记录信息
如果没有指定 sid 的话, 则返回的是所有参与该试卷考试的考试记录数据
[ { "viewResult":"https://www.hzxue.com/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接 "score": 30,//考试得分,float类型 "startTime": 1539075728,//学员开始作答的时间戳,int类型,单位s(秒) "endTime": 1539075828,//学员交卷的时间戳,int类型,单位s(秒) "status": 1,//status 表示答卷状态,1表示正常交卷, 0正在考试中,2表示超时自动交卷,3表示被管理员强制交卷,4表示系统执行交卷 "sid": 19382, "name": "王二" }, { "viewResult":"https://www.hzxue.com/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接 "score": 32,//考试得分,float类型 "startTime": 1539075628,//考生开始作答的时间戳,int类型,单位s(秒) "endTime": 1539075828,//考生交卷的时间戳,int类型,单位s(秒) "status": 1,//status 表示答卷状态,1表示正常交卷, 0正在考试中,2表示超时自动交卷,3表示被管理员强制交卷,4表示系统执行交卷 "sid": 19310, //学员的ID "name": "张三" //学员的姓名 }, ]
获取试卷列表
试卷很多的情况下需要通过接口来动态获取试卷列表。接口如下:
GET https://www.hzxue.com/api/exams/list
参数
token=权限码&start=0&limit=30
参数说明:
- token 每个账户唯一对应的验证码,string类型,该值可联系好智学获取
- start 用于数据量很大时的分页显示,表示分页的数据偏移, 默认为0, 可选参数
- limit 用于数据量很大时的分布显示,设置每页的数据显示数量,默认为30, 可选参数
返回数据:
[ { "eid": 23812,//试卷id,int类型 "title": "测试试卷", // 试卷标题,string类型 "img": "https://www.hzxue.com/xxxxx.jpg",// 试卷封面图片链接,string类型 "url": "https://www.hzxue.com/23812", //试卷考试链接,string类型 "createTime": 1539075828,//试卷创建时间的unix时间戳,int类型,单位s(秒) "available": 1, //试卷是否可用,int类型,1表示可用,0表示不可用 "times": 3918, //试卷的考试次数 "category": "模考" //试卷的分类名称 }, ... ]