REST API Tester — REST API 测试员

API Tester 使用单个命令测试、验证和基准测试 REST APIs。无外部依赖 —— 只使用 Python 标准库。 快速开始 # 测试单个端点 python3 skills/api-tester/scripts/api_tester.py --url https://api.github.com/repos/openclaw/openclaw # 使用 JSON 体发送 POST 请求 python3 skills/api-tester/scripts/api_tester.py \ --url https://jsonplaceholder.typicode.com/posts \ --method POST \ --body '{"title":"test","body":"hello","userId":1}' # 使用自定义头测试 python3 skills/api-tester/scripts/api_tester.py \ --url https://api.example.com/secure \ --headers '{"Authorization":"Bearer token123"}' 常用命令 命令 行为 --url URL 目标 API 端点（必需） --method GET|POST|PUT|DELETE|PATCH HTTP 方法 --headers '{"K":"V"}' 自定义头作为 JSON --body '{"key":"value"}' 请求 JSON 体 --body-file path.json 从文件读取体 --verbose 显示响应体 --validate 验证状态码 + 响应时间 --expected-status 201 预期 HTTP 状态（默认：200） --validate-keys id name email 预期响应中的 JSON 键 --benchmark 运行多次迭代 --iterations 10 基准测试迭代次数（默认：5） --max-time 5000 可接受的最大时间（毫秒）（默认：3000） --timeout 60 请求超时（默认：30） --report 生成 HTML 测试报告 --output report.html 将报告保存到路径 --spec openapi.json --test-all 测试来自规范的所有端点 验证 自动验证 API 响应： python3 skills/api-tester/scripts/api_tester.py \ --url https://jsonplaceholder.typicode.com/posts/1 \ --validate --validate-keys userId id title body 输出： 验证： PASS 3/3 检查通过 status_code：预期=200，实际=200 response_time：预期=<3000ms，实际=234ms key_exists：userId：预期=存在，实际=找到 基准测试 测试端点在多次迭代中的性能： python3 skills/api-tester/scripts/api_tester.py \ --url https://jsonplaceholder.typicode.com/posts \ --benchmark --iterations 10 输出： 基准测试：GET https://jsonplaceholder.typicode.com/posts 迭代次数：10 最小：142ms 最大：312ms 平均：198ms 中位数：189ms 成功：10/10 HTML 报告 生成一个样式化的 HTML 报告以便共享： python3 skills/api-tester/scripts/api_tester.py \ --url https://jsonplaceholder.typicode.com/posts/1 \ --verbose --report # 创建：api-test-report-20260510-133000.html 从 OpenAPI 规范测试 测试 OpenAPI/Swagger 规范中定义的所有端点： python3 skills/api-tester/scripts/api_tester.py \ --spec openapi.json \ --test-all 要求 Python 3.6+（无需 pip 安装） 仅使用标准库中的 urllib 适用于 Linux、macOS、Windows 无外部 API 调用