获取考生成绩¶

注：所有接口只针对黄金会员提供，非黄金会员无法调用

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

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

接口如下所示：

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(秒)
        "status": 1,//status 表示答卷状态，1表示正常交卷, 0正在考试中，2表示超时自动交卷，3表示被管理员强制交卷，4表示系统执行交卷
    },
    {
        "viewResult":"https://ks.youkaoshi.cn/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://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": "模考" //试卷的分类名称
    },
    ...
]