jiaoyu/docs/api.md

API 接口文档

Base URL: http://localhost:8000

认证模块

方法	路径	说明
POST	/api/auth/register	教师注册
POST	/api/auth/login	教师登录
GET	/api/auth/me	获取个人信息
PUT	/api/auth/me	更新个人信息

课件模块

方法	路径	说明
POST	/api/coursewares/	创建课件
GET	/api/coursewares/	课件列表(支持筛选)
GET	/api/coursewares/{id}	课件详情
PUT	/api/coursewares/{id}	更新课件
DELETE	/api/coursewares/{id}	删除课件
POST	/api/coursewares/ai-generate	AI生成课件

教学动画模块

方法	路径	说明
POST	/api/animations/	创建动画
GET	/api/animations/	动画列表
GET	/api/animations/{id}	动画详情
PUT	/api/animations/{id}	更新动画
DELETE	/api/animations/{id}	删除动画
POST	/api/animations/ai-generate	AI生成动画

互动练习模块

方法	路径	说明
POST	/api/exercises/	创建练习
GET	/api/exercises/	练习列表
GET	/api/exercises/{id}	练习详情
DELETE	/api/exercises/{id}	删除练习
POST	/api/exercises/ai-generate	AI生成练习
POST	/api/exercises/{id}/attempt	提交答题

教案模块

方法	路径	说明
POST	/api/lesson-plans/	创建教案
GET	/api/lesson-plans/	教案列表
GET	/api/lesson-plans/{id}	教案详情
DELETE	/api/lesson-plans/{id}	删除教案
POST	/api/lesson-plans/ai-generate	AI生成教案

AI能力模块

方法	路径	说明
POST	/api/ai/essay-grade	作文批改
POST	/api/ai/exam-generate	AI命题

资源库模块

方法	路径	说明
POST	/api/resources/	上传资源
GET	/api/resources/	资源列表
GET	/api/resources/{id}	资源详情
POST	/api/resources/{id}/like	点赞
DELETE	/api/resources/{id}	删除资源

教师社区模块

方法	路径	说明
POST	/api/community/posts	发布帖子
GET	/api/community/posts	帖子列表
GET	/api/community/posts/{id}	帖子详情
POST	/api/community/posts/{id}/like	点赞帖子
DELETE	/api/community/posts/{id}	删除帖子
GET	/api/community/posts/{id}/comments	评论列表
POST	/api/community/posts/{id}/comments	发表评论

认证方式

所有需要认证的接口请在请求头中携带 JWT Token：

Authorization: Bearer <access_token>

通用响应格式

成功响应:

{
  "success": true,
  "data": { ... }
}

错误响应:

{
  "detail": "错误信息描述"
}