EduOpenAI Core 文档/API 参考
API 参考
/api/edu/v1/* 插件 API 一览
所有插件 API 统一挂载于 /api/edu/v1/*（Catch-All 路由按 manifest apiRoutes 分发）。响应格式：{ success, ...data }。
课程（edu-course）
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/edu/v1/classrooms | 课堂列表 |
| POST | /api/edu/v1/classrooms | 创建课堂 |
| GET / PUT / DELETE | /api/edu/v1/classrooms/:id | 课堂详情 / 更新 / 删除 |
存储（edu-storage-aliyun）
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/edu/v1/storage/upload | OSS 上传（multipart 字段 file） |
| GET | /api/edu/v1/storage/url | OSS 预签名读取地址 |
模型（edu-model-switch）
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/edu/v1/models | 模型列表（基线 + 百炼扩充 + 免费额度标注）+ 健康检查 + 回退链状态 |
| PUT | /api/edu/v1/models/active | 运行时切换默认模型（持久化） |
| POST | /api/edu/v1/models/fallback/reset | 免费额度回退链复位 |
| POST | /api/edu/v1/models/refresh | 刷新百炼模型清单（拉取 GET /models，新增模型入清单，管理员） |
资产与用户（edu-assets）
| 方法 | 路径 | 说明 |
|---|---|---|
| GET / PUT | /api/edu/v1/assets、/api/edu/v1/assets/:id | 资产列表（?mine=1 用户过滤）/ 更新可见性·发布授权 |
| POST | /api/edu/v1/assets/import | 导入课堂 JSON 为资产 |
| DELETE | /api/edu/v1/assets/:id | 删除资产（清快照 + 撤销发布） |
| POST | /api/edu/v1/admin/login | 管理后台登录（下发 eduopenai_admin cookie） |
| GET / POST / PUT / DELETE | /api/edu/v1/referer/* | 网校域名白名单管理 |
| GET | /api/edu/v1/static-player/check | 静态播放播放校验 |
| GET | /api/edu/v1/users | 注册用户列表（含资产数，管理员） |
| GET | /api/edu/v1/users/:username/assets | 查看指定用户资产（管理员） |
| PUT | /api/edu/v1/users/:username | 禁用/启用账号（{ disabled }，管理员） |
| DELETE | /api/edu/v1/users/:username | 删除账号（级联清理资产/快照/发布，管理员） |
| GET | /api/edu/v1/quota/me | 当前用户配额与申请记录 |
| POST | /api/edu/v1/quota/apply | 申请 Token（100万/300万/1000万三档） |
| GET | /api/edu/v1/quota/applications | 申请列表（管理员） |
| POST | /api/edu/v1/quota/applications/:id/review | 审核发放/拒绝（管理员） |
| POST | /api/edu/v1/quota/:username/recycle | 回收配额（管理员） |
插件与上游（edu-admin-ext）
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/edu/v1/plugins | 插件列表（id/版本/状态/依赖/路由数，管理员） |
| POST | /api/edu/v1/plugins/:id/toggle | 启用/禁用/卸载/重装（内存态，管理员） |
| GET | /api/edu/v1/upstream/check | GitHub 上游最新 release vs 当前基线对比（管理员） |
| GET | /api/edu/v1/upstream/upgrade-report | 升级检查单（6 项，纯指引不升级，管理员） |
发布（edu-edusoho-sync）
| 方法 | 路径 | 说明 |
|---|---|---|
| POST / DELETE | /api/edu/v1/classrooms/:id/publish | 发布 / 撤销发布 |
| GET | /api/edu/v1/classrooms/:id/publish-status | 发布状态查询 |
| POST | /api/edu/v1/classrooms/:id/edusoho/task | 创建/更新智训宝课时 |
| GET | /api/edu/v1/courses、/api/edu/v1/courses/:id | 课程引用列表 / 详情 |
| GET | /api/edu/v1/embed/config、/api/edu/v1/embed/:classroomId | 播放嵌入配置 / 嵌入信息 |
| POST | /api/edu/v1/sync/edusoho | 手动触发引用同步 |
静态播放器（edu-static-player）
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/edu/v1/static-player/publish | 上传课堂静态播放产物至 OSS（仅接受已发布课堂） |