Skip to main content

一、基本信息​

接口名称：获取学校考试任务列表接口

接口说明：通过接口获取学校在指定时间范围内已完成所有类型的考试作业任务（含校内考、作业、区域考、联考等）列表，不包含进行中的考试。

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

请求地址：${BASEURL}/dataconnectorserv/integration/score/getSchoolExams

请求方式：POST

请求类型：application/json

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

接口版本：1.0

修改日期：2026-02-27

二、请求参数​

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

开始时间和结束时间均为选填项，未填写时默认返回最近三个月数据，支持查询一年内的时间范围。

{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS==",
    "beginDate":"2025-09-18",
    "endDate":"2025-09-20"
}

三、响应结果​

响应参数名称响应参数类型是否有值说明
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"
            }
        ]
    }
}