一、基本信息

---

接口名称：获取考试发布列表

请求地址：${BASEURL}/dataconnectorserv/integration/exam/getExams

请求方式：POST

请求类型：application/json

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

接口版本：3.0

修改日期：2023-12-05

小提示

对接考务接口，请先阅读“服务能力->接入概述->场景说明”，课表与考勤数据集成。

二、请求参数

---

参数名	类型	是否必填	说明
appKey	String	是	平台提供的唯一标识
schoolID	String	是	学校ID，从学校列表获取

{
    "appKey": "36s2zllw",
    "schoolID": "wca5opSRt2tyyBSLqOjdoS=="
}

三、响应结果

---

响应参数名称	响应参数类型	是否有值	说明
exams	Array	是	考试信息列表
title	String	是	考试名称
examID	String	是	考试唯一ID
exam	Array	是	考试信息列表
id	Int	是	每场考试唯一标识ID
gradeID	Int	是	学校年级唯一ID
subjectID	Int	否	科目ID
type	String	否	类型：chosenExam(选考)，studyExam(学考)，majorExam(必考)，custom(自定义)，selfStudy(自习)
time	Object	否	考试时间对象
day	String	是	考试日期
begin	String	是	考试开始时间
end	String	是	考试结束时间
timeslot	Int	是	考试间隔时间
partOfDay	String	是	morning(早上)，afternoon(下午)，evening(晚上)
outsideTeacher	Array	是	巡考教师ID
freeStudents	Array	是	放学学生ID
examRooms	Array	是	考试场地信息列表
roomID	Int	是	考场ID
roomNO	Int	是	考场编号
roomName	String	是	考场名称
locationID	Int	是	场地ID
studentCapacity	Int	是	考场学生数
students	Array	是	学生信息列表
userID	String	是	学生ID
seatNO	Int	是	座位号
studentTicket	String	是	学生准考证
insideTeachers	Array	是	场内监考老师ID

{
    "status": "success",
    "result": {
        "exams": [
            {
                "title": "考试名称",
                "examID": "考试唯一ID",
                "exam": [
                    {
                        "id": 1,
                        "gradeID": 1012017,
                        "subjectID": 1,
                        "type": "custom",
                        "time": {
                           "day": "2023-01-02",
                           "begin": "08:00",
                           "end": "12:00",
                           "timeslot": 0
                        },
                        "partOfDay": "morning",
                        "outsideTeacher": ["123"],
                        "freeStudents": ["123","1232131"],
                        "examRooms": [
                            {
                                "roomID": 1,
                                "roomNO": 1,
                                "roomName": "xxx",
                                "locationID": 1,
                                "studentCapacity": 30,
                                "students": [
                                    {"userID": "123","seatNO": 0,"studentTicket": "123123"}
                                ],
                                "insideTeachers": ["1231"]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}