# api-test-project

**Repository Path**: nnaeuu/api-test-project

## Basic Information

- **Project Name**: api-test-project
- **Description**: 第一个项目：接口自动化测试项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-23
- **Last Updated**: 2026-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 接口自动化测试项目

## 项目简介
使用Python编写接口自动化测试脚本，对RESTful API进行自动化测试，覆盖正常场景、异常场景、边界值等测试类型，自动生成HTML测试报告。

## 测试对象
- 测试平台：JSONPlaceholder（免费公开的测试API）
- 地址：https://jsonplaceholder.typicode.com
- 接口类型：RESTful API

## 技术栈
- Python 3
- Requests（HTTP请求库）
- Pytest（测试框架）
- pytest-html（HTML测试报告）

## 项目结构
```
02-接口测试项目/
├── README.md              # 项目说明
├── requirements.txt       # 依赖包
├── pytest.ini             # pytest配置文件
├── config/
│   ├── __init__.py
│   └── config.py          # API地址配置
├── test_cases/
│   ├── __init__.py
│   ├── test_posts.py      # 文章接口测试（6条用例）
│   ├── test_users.py      # 用户接口测试（4条用例）
│   ├── test_comments.py   # 评论接口测试（5条用例）
│   └── test_todos.py      # 待办事项接口测试（6条用例）
└── reports/               # 测试报告输出目录
```

## 测试覆盖接口
| 接口模块 | 接口数量 | 测试内容 |
|---|---|---|
| Posts（文章） | 4个接口 | GET列表、GET单个、POST创建、PUT更新、DELETE删除 |
| Users（用户） | 2个接口 | GET列表、GET单个 |
| Comments（评论） | 3个接口 | GET列表、按文章筛选、GET单个、POST创建 |
| Todos（待办） | 3个接口 | GET列表、按用户筛选、按完成状态筛选、POST创建 |

## 测试类型
| 类型 | 说明 |
|---|---|
| 正常场景测试 | 正确参数，验证返回结果正确 |
| 异常场景测试 | 不存在的ID，验证返回404 |
| 参数筛选测试 | 按postId、userId、completed等参数筛选 |
| 数据校验测试 | 验证返回数据字段完整性、格式正确性 |

## 用例统计
- 总用例数：21条
- 覆盖接口：12个
- 测试通过率：100%

## 运行方法

### 1. 安装依赖
```bash
pip install -r requirements.txt
```

### 2. 运行全部测试
```bash
pytest
```

### 3. 运行指定测试文件
```bash
pytest test_cases/test_posts.py
```

### 4. 查看测试报告
测试完成后，打开 `reports/report.html` 查看详细测试报告。

## 项目收获
- 掌握了接口测试基本流程：接口分析 → 用例设计 → 脚本编写 → 执行测试 → 输出报告
- 熟悉Requests库的使用：GET/POST/PUT/DELETE请求
- 掌握Pytest测试框架：用例组织、断言、测试报告生成
- 理解RESTful API测试方法