zhaog100 API Tester
Test, validate, and benchmark REST APIs with a single command. No external dependencies — uses only Python standard library.
Quick start
# Test a single endpoint
python3 skills/api-tester/scripts/api_tester.py --url https://api.github.com/repos/openclaw/openclaw
# POST with JSON body
python3 skills/api-tester/scripts/api_tester.py \
--url https://jsonplaceholder.typicode.com/posts \
--method POST \
--body '{"title":"test","body":"hello","userId":1}'
# Test with custom headers
python3 skills/api-tester/scripts/api_tester.py \
--url https://api.example.com/secure \
--headers '{"Authorization":"Bearer token123"}'
Common commands
| Command | Action |
|---|---|
--url URL |
Target API endpoint (required) |
--method GET|POST|PUT|DELETE|PATCH |
HTTP method |
--headers '{"K":"V"}' |
Custom headers as JSON |
--body '{"key":"value"}' |
Request JSON body |
--body-file path.json |
Read body from file |
--verbose |
Show response body |
--validate |
Validate status code + response time |
--expected-status 201 |
Expected HTTP status (default: 200) |
--validate-keys id name email |
Expected JSON keys in response |
--benchmark |
Run multiple iterations |
--iterations 10 |
Benchmark iterations (default: 5) |
--max-time 5000 |
Max acceptable time in ms (default: 3000) |
--timeout 60 |
Request timeout (default: 30) |
--report |
Generate HTML test report |
--output report.html |
Save report to path |
--spec openapi.json --test-all |
Test all endpoints from spec |
Validation
Validate API responses automatically:
python3 skills/api-tester/scripts/api_tester.py \
--url https://jsonplaceholder.typicode.com/posts/1 \
--validate --validate-keys userId id title body
Output:
Validation: ✅ PASS
3/3 checks passed
✅ status_code: expected=200, actual=200
✅ response_time: expected=<3000ms, actual=234ms
✅ key_exists: userId: expected=present, actual=found
Benchmarking
Test endpoint performance over multiple iterations:
python3 skills/api-tester/scripts/api_tester.py \
--url https://jsonplaceholder.typicode.com/posts \
--benchmark --iterations 10
Output:
Benchmark: GET https://jsonplaceholder.typicode.com/posts
Iterations: 10
Min: 142ms
Max: 312ms
Avg: 198ms
Median: 189ms
Success: 10/10
HTML Reports
Generate a styled HTML report for sharing:
python3 skills/api-tester/scripts/api_tester.py \
--url https://jsonplaceholder.typicode.com/posts/1 \
--verbose --report
# Creates: api-test-report-20260510-133000.html
Testing from OpenAPI Spec
Test all endpoints defined in an OpenAPI/Swagger specification:
python3 skills/api-tester/scripts/api_tester.py \
--spec openapi.json \
--test-all
Requirements
- Python 3.6+ (no pip install needed)
- Uses only
urllibfrom standard library - Works on Linux, macOS, Windows
- No external API calls