ClassCharts 是英国广泛使用的教育课堂管理平台，为教师、学生和家长提供课程表、作业、行为记录、出勤情况等核心教学管理功能。通过 classcharts-api-js 这个非官方 JavaScript/TypeScript 库，开发者可以绕过图形界面，以编程方式与 ClassCharts 平台进行深度交互。该工具支持家长和学生两种身份认证模式，分别适用于不同使用场景：家长端可集中查看多个子女的学习动态，而学生端则能自主查询个人奖励、兑换商店等专属内容。由于 API 并非由 ClassCharts 官方维护，使用时需特别注意安全规范，建议将登录凭据存储在环境变量或安全的密钥管理系统中，避免硬编码在代码或日志文件中。整体而言，这是一个面向开发者、旨在提升 ClassCharts 数据自动化处理能力的实用工具库。
核心功能特点
- 支持家长与学生双身份认证，分别获取对应权限的数据访问能力
- 可批量查询作业、课程表、行为评分、考勤记录、留校处分等关键学业信息
- 集成活动动态流接口，支持按时间范围分页拉取最新校园通知与更新
- 提供徽章成就系统与奖励商城接口，学生可查看积分并执行商品兑换
- 所有请求均基于异步操作设计，兼容 Node.js 20+ 和 Deno 运行环境
适用场景
当用户需要快速汇总孩子在一学期内的作业完成情况时，可通过调用 getHomeworks 方法指定起止日期，自动提取所有待交或已完成的任务列表，并按截止日期排序输出，极大简化人工整理过程。对于希望实时监控孩子在校表现的家长，getBehaviour 和 getAttendance 接口能按月份导出行为得分变化曲线与缺勤详情，便于发现异常趋势并及时沟通学校。若家长同时管理多名子女，ParentClient 的 selectPupil 机制允许在多个孩子间灵活切换，无需重复登录即可轮询各学生的课表和成绩。此外，学生用户可通过 getRewards 获取积分余额及可兑换物品清单，再结合 purchaseReward 完成虚拟商品购买，实现学习激励系统的自动化操作。这些功能共同构成了一个高效、可编程的 ClassCharts 数据接入层，特别适合用于构建家庭学习看板、自动化提醒系统或第三方教育辅助应用。