内容
# Pokemon API
一个为Pokemon爱好者打造的有趣API，使用FastAPI和[PokeAPI](https://pokeapi.co/)构建。
## 特性
该API提供多个端点以访问Pokemon数据：
- **获取Pokemon详情**：获取特定Pokemon的详细信息
- **比较Pokemon**：比较多个Pokemon的属性、类型和统计数据
- **传奇Pokemon**：获取所有传奇Pokemon的列表
- **顶级Pokemon**：根据基础属性总和获取顶级Pokemon
- **训练师Pokemon**：获取与著名训练师（如小智）相关的Pokemon
- **地区Pokemon**：获取特定地区（如关都、城都等）的Pokemon
- **顶级地区Pokemon**：获取每个地区的顶级Pokemon
## 安装
1. 克隆仓库
2. 安装依赖：
```
pip install -e .
```
## 使用
运行服务器：
```bash
python main.py
```
API将在 http://localhost:8000 提供服务
## API 端点
### 获取Pokemon详情
```
GET /pokemon/{name_or_id}
```
示例：`GET /pokemon/pikachu` 或 `GET /pokemon/25`
### 比较Pokemon
```
GET /pokemon/compare?pokemon_names=pikachu&pokemon_names=charizard
```
一次比较2到6个Pokemon。
### 传奇Pokemon
```
GET /pokemon/legendary
```
可选查询参数：
- `limit`：返回的Pokemon数量（默认：20）
- `offset`：分页偏移量（默认：0）
### 顶级Pokemon
```
GET /pokemon/top
```
可选查询参数：
- `limit`：返回的顶级Pokemon数量（默认：10）
### 训练师Pokemon
```
GET /pokemon/trainer/{trainer_name}
```
可用训练师：ash, misty, brock, gary, lance, cynthia
示例：`GET /pokemon/trainer/ash`
### 地区Pokemon
```
GET /pokemon/region/{region_name}
```
可用地区：kanto, johto, hoenn, sinnoh, unova, kalos, alola, galar
可选查询参数：
- `limit`：返回的Pokemon数量（默认：20）
- `offset`：分页偏移量（默认：0）
### 顶级地区Pokemon
```
GET /pokemon/region/{region_name}/top
```
可选查询参数：
- `limit`：返回的顶级Pokemon数量（默认：5）
## 文档
当服务器运行时，交互式API文档可在 http://localhost:8000/docs 访问。
