🎯 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 (4个)

• GET /api/v1/users/me

• PATCH /api/v1/users/me

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

• DELETE /api/v1/users/me

📋 DeviceSchema Management (2个)

• GET /api/v1/devices/me

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

📚 Course & Media (19个)

• GET /api/v1/course/levels

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

• GET /api/v1/course/units

• GET /api/v1/course/units/by-theme

• GET /api/v1/course/themes

🎵 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}

🎮 Gamification (3个)

• POST /api/v1/app/gamification/cards/collect

• GET /api/v1/app/gamification/cards/collected

• GET /api/v1/app/gamification/cards/library

📊 Progress & Achievements (9个)

• POST /api/v1/progress/batch

• POST /api/v1/progress/course-unit/complete

• GET /api/v1/progress/course-units/completed

• GET /api/v1/progress/course-unit/complete-status

• POST /api/v1/progress/game-pack/complete

📝 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

📋 Config (1个)

• GET /api/v1/config/switch/{key}

📋 Class Learning (12个)

• GET /api/v1/classes

• GET /api/v1/classes/my-old

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

• GET /api/v1/classes/my

• GET /api/v1/classes/courses/by-unit-sub-level

📋 Home (1个)

• GET /api/v1/app/levels/{level_id}/home-summary

📋 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

📋 App端投诉举报 (1个)

• POST /api/v1/app/reports

📋 App端反馈问卷 (4个)

• GET /api/v1/app/feedback/forms

• GET /api/v1/app/feedback/forms/{form_id}

• GET /api/v1/app/feedback/forms/{form_id}/my-responses

• PUT /api/v1/app/feedback/forms/{form_id}/questions/{question_id}/response

📋 Game Runtime (5个)

• GET /api/v1/runtime/game-index

• GET /api/v1/runtime/game-packs

• POST /api/v1/runtime/game-pack/presign

• POST /api/v1/runtime/game-pack/pack-json

• GET /api/v1/runtime/game-pack/detail

📋 Realtime Voice (1个)

• GET /realtime/api/status

应用端总计: 115个接口

💼 管理端API (Vue后台)

📋 Class Sync Alias (1个)

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

👥 User Management (7个)

• 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 (39个)

• 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 (16个)

• 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 (18个)

• POST /api/v1/admin/upload/presign

• POST /api/v1/admin/upload/presign

• POST /api/v1/admin/upload/confirm

• POST /api/v1/admin/upload/confirm

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

📋 Class Management (35个)

• 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}

📋 Export Tasks (2个)

• GET /api/v1/admin/export-tasks/{task_id}

• GET /api/v1/admin/export-tasks/{task_id}/download

📋 Independent Course Management (19个)

• 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 (11个)

• 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

📋 投诉举报管理 (3个)

• GET /api/v1/admin/reports

• GET /api/v1/admin/reports/{report_id}

• PATCH /api/v1/admin/reports/{report_id}

📋 反馈问卷管理 (9个)

• POST /api/v1/admin/feedback/forms

• PUT /api/v1/admin/feedback/forms/{form_id}

• PUT /api/v1/admin/feedback/forms/{form_id}/publish

• PUT /api/v1/admin/feedback/forms/{form_id}/close

• DELETE /api/v1/admin/feedback/forms/{form_id}

📋 Game Assets Management (7个)

• POST /api/v1/admin/game-assets

• GET /api/v1/admin/game-assets

• PUT /api/v1/admin/game-assets/config

• GET /api/v1/admin/game-assets/{asset_id}

• PATCH /api/v1/admin/game-assets/{asset_id}

📋 Game Builds Management (2个)

• POST /api/v1/admin/game-builds

• GET /api/v1/admin/game-builds/{build_id}

📋 Game Promotions Management (3个)

• POST /api/v1/admin/game-promotions

• GET /api/v1/admin/game-promotions

• PATCH /api/v1/admin/game-promotions/{release_id}

📋 Game Packs Management (9个)

• POST /api/v1/admin/game-packs

• POST /api/v1/admin/game-packs/create

• GET /api/v1/admin/game-packs/detail

• PUT /api/v1/admin/game-packs/update

• GET /api/v1/admin/game-packs

📋 Game Types Management (5个)

• POST /api/v1/admin/game-types

• GET /api/v1/admin/game-types

• GET /api/v1/admin/game-types/{type_id}

• PATCH /api/v1/admin/game-types/{type_id}

• DELETE /api/v1/admin/game-types/{type_id}

📋 COS Sync Management (9个)

• POST /api/v1/admin/cos-sync/scan

• POST /api/v1/admin/cos-sync/scan-cos

• POST /api/v1/admin/cos-sync/scan-local

• POST /api/v1/admin/cos-sync/{batch_id}/prepare-upload

• POST /api/v1/admin/cos-sync/{batch_id}/execute

管理端总计: 237个接口

🎯 API架构特点

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

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

🎯 总接口数
423个
应用端115个 + 管理端237个
✅ 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

🚀 状态: 生产就绪