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

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=\x3C3000ms, 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 urllib from standard library
• Works on Linux, macOS, Windows
• No external API calls