注: 所有接口只针对企业会员提供,非企业会员无法调用
获取某一学员参与考试的记录
通过该接口,可以获取学员在某一份试卷下的学员成绩。
接口如下所示:
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": "模考" //试卷的分类名称
},
...
]