1. 首页
  2. 开放平台
  3. 获取学员成绩

获取学员成绩

注: 所有接口只针对企业会员提供,非企业会员无法调用

获取某一学员参与考试的记录

通过该接口,可以获取学员在某一份试卷下的学员成绩。

接口如下所示:

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": "模考" //试卷的分类名称
    },
    ...
]
更新于 12月 21, 2020 by neugls

这篇文章对您有帮助吗?

相关文章