🎯 InputBaby Backend API

输入宝儿童教育平板后端服务 - 为0-7岁儿童提供优质学习内容

📊 服务状态

✅ API服务运行正常

📚 视频内容已加载

🔒 CORS跨域配置完成

🛡️ 统一异常处理启用

🔄 响应格式已标准化

📖 API文档
Swagger UI 📋 API规范
ReDoc 🎬 媒体资源
视频/音频 📚 课程等级
等级列表 🔍 健康检查
系统状态

🚀 API接口完整概览 (实时统计)

📱 应用端API (Flutter)

🔐 Authentication & User (9个)

• POST /api/v1/auth/device-register

• POST /api/v1/auth/device-login

• POST /api/v1/auth/logout

• POST /api/v1/auth/send-sms-code

• POST /api/v1/auth/login-with-sms

📋 Authentication & UserSchema (3个)

• GET /api/v1/users/me

• PATCH /api/v1/users/me

• POST /api/v1/users/cache/clear

📋 DeviceSchema Management (2个)

• GET /api/v1/devices/me

• POST /api/v1/devices/test/get-token

📚 Course & Media (17个)

• GET /api/v1/course/levels

• GET /api/v1/course/levels/{level_id}

• GET /api/v1/course/units

• GET /api/v1/course/units/{unit_id}

• GET /api/v1/course/tags

🎵 Playlist & Social (16个)

• GET /api/v1/playlists

• POST /api/v1/playlists

• GET /api/v1/playlists/{playlist_id}

• PATCH /api/v1/playlists/{playlist_id}

• DELETE /api/v1/playlists/{playlist_id}

📊 Progress & Achievements (5个)

• POST /api/v1/progress/batch

• GET /api/v1/progress

• GET /api/v1/progress/stats

• GET /api/v1/progress/achievements

• POST /api/v1/progress/achievements/check

📝 User Events (4个)

• POST /api/v1/events/batch

• GET /api/v1/events/stats

• POST /api/v1/events/log

• GET /api/v1/events/history

🔧 System (4个)

• GET /api/v1/system/version

• GET /api/v1/system/update-check

• GET /api/v1/system/changelog/{version}

• GET /api/v1/system/health

📋 Class Learning (8个)

• GET /api/v1/classes

• GET /api/v1/classes/my

• GET /api/v1/classes/{class_id}

• GET /api/v1/classes/{class_id}/courses

• GET /api/v1/classes/{class_id}/courses/{course_id}

📋 App端富文本 (3个)

• GET /api/v1/app/course-units/{course_unit_id}/richtext

• GET /api/v1/app/courses/{course_id}/richtext

• POST /api/v1/app/course-units/{course_unit_id}/interactions

📋 App端上传 (2个)

• POST /api/v1/app/uploads/user-media/presign

• POST /api/v1/app/media/batch-urls

📋 App | Interactions (8个)

• GET /api/v1/app/interactions/courses/{course_id}/interactions

• GET /api/v1/app/interactions/mine

• GET /api/v1/app/interactions/feed

• GET /api/v1/app/interactions/{interaction_id}

• POST /api/v1/app/interactions/courses/{course_id}/interactions

📋 App端理论课答题 (3个)

• GET /api/v1/app/course-units/{course_unit_id}/qa

• POST /api/v1/app/qa/{qa_id}/answer

• GET /api/v1/app/richtext/{richtext_id}/qa-completion

📋 Leaderboard & Points (4个)

• GET /api/v1/app/classes/{class_id}/leaderboard/points

• GET /api/v1/app/classes/{class_id}/leaderboard/featured

• GET /api/v1/app/points/summary

• GET /api/v1/app/leaderboard/watch-time

应用端总计: 88个接口

💼 管理端API (Vue后台)

📋 Class Sync Alias (1个)

• POST /api/v1/class/sync-from-demo

👥 User Management (6个)

• GET /api/v1/admin/users

• POST /api/v1/admin/users

• GET /api/v1/admin/users/{user_id}

• PATCH /api/v1/admin/users/{user_id}

• DELETE /api/v1/admin/users/{user_id}

📱 Device Management (3个)

• GET /api/v1/admin/devices/

• GET /api/v1/admin/devices/{device_id}

• PATCH /api/v1/admin/devices/{device_id}

📖 Course Management (35个)

• GET /api/v1/admin/course/levels

• GET /api/v1/admin/course/levels/{level_id}

• POST /api/v1/admin/course/levels

• PATCH /api/v1/admin/course/levels/{level_id}

• DELETE /api/v1/admin/course/levels/{level_id}

🎵 Playlist Management (14个)

• GET /api/v1/admin/playlists

• POST /api/v1/admin/playlists

• GET /api/v1/admin/playlists/{playlist_id}

• PATCH /api/v1/admin/playlists/{playlist_id}

• DELETE /api/v1/admin/playlists/{playlist_id}

🎮 Gamification (10个)

• GET /api/v1/admin/gamification/challenges

• POST /api/v1/admin/gamification/challenges

• PATCH /api/v1/admin/gamification/challenges/{challenge_id}

• DELETE /api/v1/admin/gamification/challenges/{challenge_id}

• GET /api/v1/admin/gamification/analytics

📋 Progress Analytics (3个)

• GET /api/v1/admin/progress/report/{user_id}

• POST /api/v1/admin/progress/user/{user_id}/reset

• GET /api/v1/admin/analytics/platform-stats

📊 Progress & Achievements (2个)

• GET /api/v1/admin/progress/report/{user_id}

• POST /api/v1/admin/progress/user/{user_id}/reset

📊 Analytics (1个)

• GET /api/v1/admin/analytics/platform-stats

📋 Media Upload (12个)

• POST /api/v1/admin/upload/media/batch-urls

• POST /api/v1/admin/upload/media/batch-urls

• POST /api/v1/admin/upload/media

• POST /api/v1/admin/upload/media

• GET /api/v1/admin/upload/status/{task_id}

📋 Class Management (30个)

• GET /api/v1/admin/classes

• POST /api/v1/admin/classes

• GET /api/v1/admin/classes/{class_id}

• PATCH /api/v1/admin/classes/{class_id}

• DELETE /api/v1/admin/classes/{class_id}

📋 Independent Course Management (12个)

• GET /api/v1/admin/course/independent

• POST /api/v1/admin/course/independent

• GET /api/v1/admin/course/independent/{course_id}

• PATCH /api/v1/admin/course/independent/{course_id}

• DELETE /api/v1/admin/course/independent/{course_id}

📋 Role Management (9个)

• GET /api/v1/admin/roles

• POST /api/v1/admin/roles

• GET /api/v1/admin/roles/audit-logs

• GET /api/v1/admin/roles/audit-logs/stats

• GET /api/v1/admin/roles/{role_id}

📋 Parent RichText (10个)

• GET /api/v1/admin/courses/{course_id}/context

• GET /api/v1/admin/course-units/{course_unit_id}/richtext

• POST /api/v1/admin/course-units/{course_unit_id}/richtext

• PATCH /api/v1/admin/course-units/{course_unit_id}/richtext

• PATCH /api/v1/admin/course-units/{course_unit_id}/richtext/status

📋 Course RichText (5个)

• GET /api/v1/admin/courses/{course_id}/richtext

• POST /api/v1/admin/courses/{course_id}/richtext

• PATCH /api/v1/admin/courses/{course_id}/richtext

• PATCH /api/v1/admin/courses/{course_id}/richtext/status

• DELETE /api/v1/admin/courses/{course_id}/richtext

📋 Interaction Management (8个)

• GET /api/v1/admin/courses/{course_id}/interactions

• GET /api/v1/admin/interactions/{id}

• POST /api/v1/admin/courses/{course_id}/interactions

• POST /api/v1/admin/interactions/{parent_id}/reply

• PUT /api/v1/admin/interactions/{id}

📋 System Media Management (5个)

• POST /api/v1/admin/system-media/upload

• GET /api/v1/admin/system-media

• GET /api/v1/admin/system-media/{media_id}

• PUT /api/v1/admin/system-media/{media_id}

• DELETE /api/v1/admin/system-media/{media_id}

📋 Frontend Logs (2个)

• POST /api/v1/admin/frontend-logs

• GET /api/v1/admin/frontend-logs

管理端总计: 160个接口

🎯 API架构特点

📱 移动优化
针对Flutter客户端的轻量级API
🔒 分层权限
App端公开 + Admin端JWT保护
🚀 高性能
异步SQLAlchemy + 分页查询
📊 丰富筛选
多维度搜索和智能推荐

📊 API统计信息 (实时更新)

🎯 总接口数
317个
应用端88个 + 管理端160个
✅ API版本
1.0.0
生产就绪
🔄 响应格式
统一标准化
100%完成
🏗️ 架构设计
微服务
FastAPI + 异步
🛡️ 安全机制
JWT认证
Token黑名单
📊 数据库
SQLite
18张核心表

📄 统一响应格式

// 成功响应
{"code": 200, "message": "success", "data": {...}}

// 分页响应
{"code": 200, "message": "success", "data": {"items": [...], "total": 10, "page": 1, "pages": 2}}

// 错误响应
{"code": 404, "message": "Resource not found", "error_details": {...}}

🔗 基础URL: http://localhost:8000

📱 支持平台: Android, iOS, Flutter Web

🚀 状态: 生产就绪