美搭 (Meida) API 服务

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

项目结构

meida-api/
├── app/                    # 应用目录
│   ├── api/                # API相关模块
│   │   └── v1/             # API版本1
│   ├── core/               # 核心配置
│   ├── db/                 # 数据库相关
│   ├── models/             # 数据模型
│   │   └── users.py        # 用户模型
│   ├── schemas/            # 数据验证模式
│   │   └── user.py         # 用户数据模式
│   └── services/           # 业务服务层
│       └── user.py         # 用户服务
├── main.py                 # 应用入口
├── init_db.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 init_db.py

4. 运行服务

python main.py

或

uvicorn main:app --reload

5. 访问API文档

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

API端点

基础端点

• /health - 健康检查

V1 API

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

用户API

• /api/v1/users/ - 获取所有用户 (GET) / 创建用户 (POST)
• /api/v1/users/{user_id} - 获取/更新/删除特定用户
• /api/v1/users/openid/{openid} - 通过openid获取用户
• /api/v1/users/me - 获取当前登录用户信息 (需要认证)
• /api/v1/users/me - 更新当前登录用户信息 (需要认证)

认证API

• /api/v1/auth/login/wechat - 微信登录/注册

认证

本API使用JWT令牌进行认证。认证流程如下：

1. 调用微信登录接口获取令牌：

POST /api/v1/auth/login/wechat
{
  "code": "微信临时登录凭证"
}

2. 在需要认证的请求头中添加令牌：

Authorization: Bearer <access_token>

数据模型

用户模型

• id: 自增长主键
• openid: 用户唯一标识
• unionid: 统一标识
• avatar: 用户头像
• nickname: 用户昵称
• create_time: 创建时间