Skip to main content

一、基本信息​

接口名称：获取最新学校考试列表接口

接口说明：获取考试已完成且报告最新数据生成时间在指定范围内的考试列表。新增的已完成考试信息也可通过此接口查询。

业务场景：1、所有考试都会生成报告。2、学生成绩修改无法通过此接口立即查询到，但重新生成报告后，可以重新获取数据。

使用场景：可用于对试卷详情，学生成绩，学生小题分数据进行更新。

接口地址：${BASEURL}/dataconnectorserv/integration/score/getUpdatedSchoolExams

请求方式：POST

请求类型：application/json

接口频率：接口调用上限500次/天

接口版本：1.0

修改日期：2026-02-27

二、请求参数​

参数名类型是否必填说明
appKeyString是平台提供的唯一标识
schoolIDString是学校ID，从学校列表获取
beginTimeString否开始时间，选填，日期标准格式"yyyy-MM-dd HH:mm:ss"
小提示

beginTime即考试报告数据变化的起始时间，未填写时默认返回近一月内有更新的考试任务，支持查询一年内的数据，且起始时间不能晚于当前时间。

{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS==",
    "beginTime":"2026-02-26 19:00:00"
}

三、响应结果​

响应参数名称响应参数类型是否有值说明
examsArray[Object]是考试列表
examIDLong是考试ID
examNameString是考试名称
examTypeString是常规诊断，期中诊断，期末诊断，模拟训练，题卡合一，跨校诊断，线上作业，区域诊断，异步诊断，线下作业
examDateString是考试日期，（用户设置的考试开始时间）
{
    "code": 0,
    "status": "success",
    "result": {
        "exams": [
            {
                "examID": 10086,
                "examName": "第一次月考",
                "examType": "常规诊断",
                "examDate": "2025-09-18"
            },
            {
                "examID": 10087,
                "examName": "第一次月考",
                "examType": "期中诊断",
                "examDate": "2025-09-19"
            }
        ]
    }
}