📡 API 文档预览
尨植智能花盆系统 v2.1 提供完整的 RESTful API 与 MQTT 接口， 支持传感器、记忆、认知、社交、语音等全部能力。 线上环境为保障接口安全，暂不开放交互式 Swagger；如需完整调试，请在本地开发环境运行。
🌱 花盆小助手：API 文档受控访问中，看看下方的接口速览吧～
🔒 访问说明
生产环境已关闭 /docs 与 /openapi.json 的公开访问，避免接口结构泄露。
本地开发时可通过 http://localhost:8000/docs 查看 Swagger UI。
所有业务接口统一位于 /api/v1/ 路径下，返回格式为 { code: 200, data: ... }。
🧠 记忆系统
- POST/api/v1/memory/classify主题分类
- POST/api/v1/memory/store存储记忆
- GET/api/v1/memory/recent近期记忆
- POST/api/v1/memory/compress记忆压缩
- POST/api/v1/memory/semantic-search语义联想检索
- GET/api/v1/memory/life-story生命故事
- GET/api/v1/memory/keyframes关键帧列表
💚 自我认知
- POST/api/v1/cognition/health-diagnose健康诊断
- GET/api/v1/cognition/body-schema身体图式
- GET/api/v1/cognition/growth-model生长模型
- POST/api/v1/cognition/self-reflection自我反思
- POST/api/v1/cognition/sensor-cross-validate交叉验证
🌐 社交群聊
- POST/api/v1/social/start-chat发起群聊
- POST/api/v1/social/next-round推进一轮
- GET/api/v1/social/friendship查询友谊
- POST/api/v1/social/human-join人类入场
🌱 花盆 & 传感器
- GET/api/v1/pot/list花盆列表
- GET/api/v1/sensor/latest/{pot_id}最新传感器数据
- GET/api/v1/sensor/history/{pot_id}历史数据
- GET/api/v1/sensor/alerts/{pot_id}告警列表
🤖 语音 & 对话
- POST/api/v1/chat植物对话
- POST/api/v1/stt语音转文字
- POST/api/v1/tts文字转语音
- POST/api/v1/voiceprint/enroll声纹注册
- POST/api/v1/voiceprint/verify声纹验证