api/README.md

美搭 (Meida) API 服务

一个基于FastAPI构建的API服务项目。

项目结构

meida-api/
├── app/                    # 应用目录
│   ├── api/                # API相关模块
│   │   └── v1/             # API版本1
│   ├── core/               # 核心配置
│   ├── db/                 # 数据库相关
│   ├── models/             # 数据模型
│   ├── schemas/            # 数据验证模式
│   └── services/           # 业务服务层
├── main.py                 # 应用入口
└── requirements.txt        # 项目依赖

安装与运行

1. 创建虚拟环境 (推荐)

python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate     # Windows

2. 安装依赖

pip install -r requirements.txt

3. 运行服务

python main.py

或

uvicorn main:app --reload

4. 访问API文档

• Swagger文档: http://localhost:8000/docs
• ReDoc文档: http://localhost:8000/redoc

API端点

• /api/v1/ - API基本信息
• /api/v1/products - 获取产品列表
• /api/v1/products/{product_id} - 获取特定产品详情
• /health - 健康检查