跳转至

获取考生成绩

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

获取某一考生参与考试的记录

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

接口如下所示:

GET https://www.youkaoshi.cn/index.php?option=com_exams&task=api.queryResults&format=raw

参数:

code=权限码&eid=试卷ID&sid=学生ID&start=0&limit=30

参数说明:

  • code 每个账户唯一对应的验证码,string类型,该值可联系优考试获取
  • eid 表示试卷ID
  • sid 表示考生ID, 可选参数,如果该参数为0或没有提供,则会显示参与该试卷考试的所有人员
  • start 用于数据量很大时的分页显示,表示分页的数据偏移, 默认为0, 可选参数
  • limit 用于数据量很大时的分布显示,设置每页的数据显示数量,默认为30, 可选参数

该接口返回考生在这个试卷里的所有考试记录信息

[
    {
        "viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接
        "score": 30,//考试得分,float类型
        "startTime": 1539075728,//考生开始作答的时间戳,int类型,单位s(秒)
        "endTime": 1539075828,//考生交卷的时间戳,int类型,单位s(秒)
    },
    {
        "viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接
        "score": 32,//考试得分,float类型
        "startTime": 1539075628,//考生开始作答的时间戳,int类型,单位s(秒)
        "endTime": 1539075828,//考生交卷的时间戳,int类型,单位s(秒)
    },
]

获取参与考试的所有考试记录信息

如果没有指定 sid 的话, 则返回的是所有参与该试卷考试的考试记录数据

[
    {
        "viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接
        "score": 30,//考试得分,float类型
        "startTime": 1539075728,//考生开始作答的时间戳,int类型,单位s(秒)
        "endTime": 1539075828,//考生交卷的时间戳,int类型,单位s(秒)
        "sid": 19382,
        "name": "王二"
    },
    {
        "viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看详细考试详情的链接,有30分钟时间限制,超过30分钟后得重新获取链接
        "score": 32,//考试得分,float类型
        "startTime": 1539075628,//考生开始作答的时间戳,int类型,单位s(秒)
        "endTime": 1539075828,//考生交卷的时间戳,int类型,单位s(秒)
        "sid": 19310, //考生的ID 
        "name": "张三" //考生的姓名
    },
]

获取试卷列表

试卷很多的情况下需要通过接口来动态获取试卷列表。接口如下:

GET https://www.youkaoshi.cn/index.php?option=com_exams&task=api.getExams&format=raw

参数

code=权限码&start=0&limit=30

参数说明:

  • code 每个账户唯一对应的验证码,string类型,该值可联系优考试获取
  • start 用于数据量很大时的分页显示,表示分页的数据偏移, 默认为0, 可选参数
  • limit 用于数据量很大时的分布显示,设置每页的数据显示数量,默认为30, 可选参数

返回数据:

[
    {
        "eid": 23812,//试卷id,int类型
        "title": "测试试卷", // 试卷标题,string类型
        "img": "https://fs.youkaoshi.cn/xxxxx.jpg",// 试卷封面图片链接,string类型
        "url": "https://ks.youkaoshi.cn/23812", //试卷考试链接,string类型
        "createTime": 1539075828,//试卷创建时间的unix时间戳,int类型,单位s(秒)
        "available": 1, //试卷是否可用,int类型,1表示可用,0表示不可用
        "times": 3918, //试卷的考试次数
        "category": "模考" //试卷的分类名称
    },
    ...
]