使用 Python 进行 API 接口测试是非常常见的一项任务，尤其是在自动化测试、接口调试和系统集成中。我们可以使用 `requests` 库来发送 HTTP 请求，并结合 `unittest` 或 `pytest` 来做断言和组织测试用例。 --- ### ✅ 功能目标 - 发送 GET / POST 等类型的请求 - 设置 headers 和参数 - 获取响应内容 - 对响应状态码、返回值等进行断言 - 生成测试报告（可选） --- ### ✅ 安装依赖 ```bash pip install requests pytest ``` --- ## 🧪 示例：使用 `requests` + `pytest` 编写 API 测试 ### 示例接口： 假设我们要测试一个 RESTful API 接口： - URL: `https://jsonplaceholder.typicode.com/posts/1` - Method: GET - Expected Status Code: 200 - Expected JSON Response: ```json { "userId": 1, "id": 1, "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit", "body": "quia et suscipit\nsuscipit..." } ``` --- ### ✅ Python代码实现 ```python import requests import pytest # 被测接口地址 BASE_URL = "https://jsonplaceholder.typicode.com/posts/1" def test_api_get_request(): # 发送GET请求 response = requests.get(BASE_URL) # 断言状态码是否为200 assert response.status_code == 200, f"Expected status code 200, but got {response.status_code}" # 解析JSON响应 data = response.json() # 断言返回字段是否存在 assert 'userId' in data assert 'id' in data assert 'title' in data assert 'body' in data # 断言具体字段值 assert data['userId'] == 1 assert data['id'] == 1 assert data['title'] == "sunt aut facere repellat provident occaecati excepturi optio reprehenderit" assert isinstance(data['body'], str) print("✅ 所有断言通过！") # 可以添加更多测试用例 def test_invalid_post_id(): response = requests.get("https://jsonplaceholder.typicode.com/posts/9999") assert response.status_code == 200, "无效ID也应返回200（因为服务端不校验）" ``` --- ### 🔍 说明： - `requests.get(url)`：发送 GET 请求。 - `response.status_code`：获取 HTTP 响应状态码。 - `response.json()`：将响应体转换为 JSON 格式。 - 使用 `assert` 进行断言验证结果。 - 如果你使用 `pytest` 框架，可以直接运行整个文件执行多个测试用例。 --- ### 🧾 如何运行 #### 方法一：命令行运行（推荐使用 pytest） ```bash pytest your_script_name.py -v ``` #### 方法二：直接运行脚本（如果用了 `if __name__ == "__main__"`） ```bash python your_script_name.py ``` --- ### 🚀 高级功能（可选） 你可以扩展以下功能： | 功能 | 描述 | |------|------| | 请求头设置 | 添加 headers（如 Content-Type、Authorization） | | 参数化测试 | 使用 `@pytest.mark.parametrize` 测试多组数据 | | 日志记录 | 使用 `logging` 模块记录日志 | | 测试报告 | 使用 `pytest-html` 生成 HTML 报告 | | 自动化测试框架 | 结合 `Allure`, `Pytest`, `Requests` 构建完整的测试框架 | ---