| name | test-api-basic-function |
| description | 执行API基础功能验证测试，自动生成正向、负向和边界测试用例并执行，生成Markdown测试报告。支持Playwright MCP，适用于接口开发完成后的功能验证、输入校验测试、边界条件测试等场景。 |
API基础功能验证测试
技能概述
本技能用于执行API的基础功能验证测试，确保接口在正常和异常情况下的行为符合预期。这是所有测试的基础，用于验证核心校验功能的正常性。
技术栈：Playwright MCP工具
测试类型：接口测试（正向、负向、边界测试）
报告格式：Markdown
快速开始
最小化测试示例
假设你要测试一个用户登录接口，只需提供以下信息：
- 接口URL: https://api.example.com/users/login
- 请求方法: POST
- 请求头: {"Content-Type": "application/json"}
- 请求参数:
- username: string, 必填, 3-50字符
- password: string, 必填, 6-100字符
系统将自动生成并执行以下测试用例：
正向测试：
负向测试：
- 用户名不存在
- 密码错误
- 缺少用户名参数
- 缺少密码参数
- 用户名格式错误
- 密码格式错误
边界测试：
- 用户名最小长度（3字符）
- 用户名最大长度（50字符）
- 密码最小长度（6字符）
- 密码最大长度（100字符）
测试完成后，自动生成Markdown格式的测试报告。
测试场景
1. 正向测试用例
验证正常条件下的API响应，确保接口在合法输入下能够正常工作。
测试要点：
- 使用合法的请求参数
- 验证HTTP状态码（通常为200、201、204等）
- 验证响应数据结构和内容
- 验证业务逻辑正确性
- 验证响应时间在合理范围内
2. 负向测试用例
验证无效输入和异常情况下的API行为，确保接口能够正确处理错误情况。
测试要点：
- 必填参数缺失
- 参数类型错误（如字符串传数字）
- 参数格式错误（如邮箱格式、手机号格式）
- 参数值超出允许范围
- 重复提交相同数据
- 不存在的资源ID
- 无效的枚举值
- 超长字符串
- 特殊字符注入
3. 边界测试用例
验证最小和最大输入值，确保接口在边界条件下的稳定性。
测试要点：
- 最小值边界（如0、1、-1）
- 最大值边界（如最大长度、最大数值）
- 边界值+1和边界值-1
- 空值、null值
- 空数组、空对象
- 极小值和极大值
测试检查清单
在执行测试前，请按以下清单逐项检查和执行：
✅ 准备阶段检查清单
✅ 测试用例生成检查清单
✅ 测试执行检查清单
正向测试：
负向测试：
边界测试：
✅ 测试报告检查清单
⚠️ 注意事项
- 每完成一个检查项，请及时标记为已完成
- 如遇失败用例，需记录详细错误信息和复现步骤
- 测试过程中如发现问题，及时记录并反馈
- 确保测试报告包含完整的测试结果和统计数据
测试执行流程
步骤1：收集测试信息
在开始测试前，需要收集以下信息：
- 业务名称：用于组织测试报告目录
- 接口名称：被测试的API接口名称
- 接口URL：完整的API端点地址
- 请求方法：GET、POST、PUT、DELETE等
- 请求头：Content-Type等
- 请求参数：参数列表、类型、是否必填、取值范围
- 预期响应：正常情况下的响应结构
- 认证信息（可选）：如需认证，提供Token键值对列表（支持多个token）
- Token 1的key：例如 Authorization、token、X-Auth-Token、lesseeadmintoken、lesseemanagetoken
- Token 1的value：例如 eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9（直接提供token值，无需添加"Bearer"前缀）
- Token 2的key：（如需要多个token，继续提供）
- Token 2的value：（如需要多个token，继续提供）
- 以此类推...
步骤2：自动生成测试用例
根据接口定义，系统自动生成三类测试用例：
正向测试用例示例：
负向测试用例示例：
- 负向测试 - 必填参数缺失
- 负向测试 - 参数类型错误
- 负向测试 - 参数格式错误
- 负向测试 - 参数值超出范围
边界测试用例示例：
- 边界测试 - 参数最小值
- 边界测试 - 参数最大值
- 边界测试 - 空值处理
步骤3：执行测试用例
使用Playwright MCP工具执行测试：
支持的HTTP方法：
- GET：查询数据
- POST：创建数据
- PUT：更新数据（全量）
- PATCH：更新数据（部分）
- DELETE：删除数据
测试执行流程：
-
正向测试执行：
- 使用合法参数调用接口
- 验证HTTP状态码（200、201、204等）
- 验证响应数据结构和内容
- 记录响应时间
-
负向测试执行：
- 使用无效参数调用接口
- 验证错误状态码（400、401、403、404等）
- 验证错误信息的准确性
- 记录错误详情
-
边界测试执行：
- 使用边界值调用接口
- 验证接口在边界条件下的行为
- 记录测试结果和异常情况
特殊场景处理：
- 文件上传接口：使用Playwright的文件上传功能，指定文件路径即可。
- 需要认证的接口：在请求头中添加Authorization字段，格式根据接口要求而定，例如：
- Authorization: Bearer {token}
- token: {token}
- X-Auth-Token: {token}
步骤4：生成测试报告
测试完成后，生成Markdown格式的测试报告，报告保存在以下目录：
doc/{业务名称}/测试报告/基础功能验证/{测试接口名称}_{时间戳}.md
