Moodle Gradebook Interpreter
收藏资源简介：
Analyzes a Moodle gradebook export and returns statistics, at-risk students, executive summary and recommendation in one JSON response.
数据集概述：Moodle Gradebook Interpreter
该API用于自动分析Moodle成绩册导出文件，并一次性返回统计信息、风险学生名单、高层摘要及教学建议，以JSON格式呈现，旨在替代教师手动查看电子表格的工作。
核心功能
- 一键分析：上传Moodle成绩册导出文件，返回完整分析结果。
- 核心输出：
- 描述性统计（均值、中位数、最小值、最大值、标准差等）
- 10个区间的直方图
- 风险学生检测（低于均值的学生）
- 执行摘要（班级整体状态文本）
- 教学建议（针对低分学生的具体行动）
- 自由文本洞察（基于数据的自动生成的解释性语句）
使用说明
- 请求方式：
POST请求，端点路径为/moodle-gradebook-interpreter。 - 请求参数：
file（必填）：成绩册文件，以multipart/form-data格式上传，支持扩展名为.csv,.txt,.xlsx,.xls,.ods,.xml。lang（可选）：输出语言，"es"（西班牙语）或"en"（英语），默认值为"es"。
- 文件限制：
- 最大请求体：25 MB。
- 内部解析限制：20 MB / 100,000行。
响应格式（成功时返回200）
返回JSON对象，包含以下字段：requestId, durationMs, rowCount, columns, chart（标签与数值）, histogram（区间与计数）, stats（统计指标）, atRisk（风险学生列表）, classStatus（班级状态）, executiveSummary, recommendation, insights, columnAverages（当文件包含2个及以上数值列时返回各列平均值，否则为null）。
错误处理
所有错误统一采用 {"error":{"code":"...","message":"..."}} 结构。常见错误码包括：
| 状态码 | 错误码 | 触发条件 |
|---|---|---|
| 400 | INVALID_INPUT | 请求体格式错误，或文件字段缺失/为空 |
| 401 | UNAUTHORIZED | 缺少或API密钥无效 |
| 413 | PAYLOAD_TOO_LARGE | 请求体超过25 MB |
| 415 | UNSUPPORTED_MEDIA_TYPE | 内容类型错误或文件扩展名不支持 |
| 422 | NOT_TABULAR | 文件可解析但不具备成绩册特征（行数少于3或无数值列） |
| 422 | UNPROCESSABLE_DATA | 文件解析失败（如超过内部大小/行数限制） |
| 500 | INTERNAL_ERROR | 服务器意外错误 |
已知限制
API运行在Cloudflare基础设施上，每个请求有CPU时间限制。非常大或复杂的文件可能偶尔触发通用平台错误（而非上述错误码）。若持续出现该问题，建议使用较小的导出文件或联系API提供者。
提供者信息
- API创建者：Raúl Vicente San Juan
- 订阅者数量：1
- 分类：教育（Education）
API调用示例（cURL）
bash curl -X POST "https://moodle-gradebook-interpreter.p.rapidapi.com/moodle-gradebook-interpreter" -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" -H "X-RapidAPI-Host: moodle-gradebook-interpreter.p.rapidapi.com" -F "file=@gradebook.xlsx" -F "lang=en"
