获取考试列表

查询教师可见的考试列表，支持多种筛选条件。

方法定义

def get_exams(
    year: int = 0,
    index: int = 1,
    class_id: str = "all",
    exam_name: str = "",
    grade_code: str = "all",
    subject_code: str = "all",
    exam_type_code: str = "all",
    page_size: int = 15,
    page_index: int = 1
) -> PageExam

参数

参数	类型	默认值	描述
year	int	0	学年 (如 2022)
index	int	1	学期索引
class_id	str	"all"	班级 ID
exam_name	str	""	考试名称筛选
grade_code	str	"all"	年级代码
subject_code	str	"all"	学科代码
exam_type_code	str	"all"	考试类型代码
page_size	int	15	每页数量
page_index	int	1	当前页码

返回值

返回 PageExam（包含考试列表和分页信息）。

示例代码

# 获取第一页考试列表（默认15条）
page_exam = teacher.get_exams()

# 打印考试信息
print(f"总共有 {len(page_exam.exams)} 场考试")
print(f"当前第 {page_exam.page_index} 页, 共 {page_exam.all_pages} 页")
for exam in page_exam.exams:
    print(f"考试名称: {exam.name}")
    print(f"考试ID: {exam.id}")
    print("---")

# 按名称搜索考试
page_exam2 = teacher.get_exams(exam_name="期中考试")

# 获取指定班级的考试
page_exam3 = teacher.get_exams(class_id="123456")

# 按学科筛选
page_exam4 = teacher.get_exams(subject_code="02")  # 数学

# 获取第2页，每页20条
page_exam5 = teacher.get_exams(page_size=20, page_index=2)

返回示例

总共有 15 场考试
当前第 1 页, 共 10 页
考试名称: XX中学2026年期末考试
考试ID: 234567
---
考试名称: XX中学6月月考
考试ID: 234566
---