Api Tester

Systematic REST and GraphQL API endpoint testing: happy path, error cases, auth flows, rate limits, schema validation. Use when: testing backend APIs, validating endpoint responses, checking error handling, verifying auth/permissions, or benchmarking API performance.

Scripts

api-test.py

Run API tests from a JSON test spec. Reports pass/fail with response details.

# From file
python3 scripts/api-test.py --spec tests.json

# From stdin
echo '{"base_url":"https://httpbin.org","tests":[{"name":"get","method":"GET","path":"/get","expect_status":200}]}' | python3 scripts/api-test.py

Test spec format:

{
  "base_url": "http://localhost:3000",
  "default_headers": { "Authorization": "Bearer TOKEN" },
  "tests": [
    {
      "name": "list users",
      "method": "GET",
      "path": "/api/users",
      "expect_status": 200,
      "expect_json": { "type": "object" }
    },
    {
      "name": "create user",
      "method": "POST",
      "path": "/api/users",
      "headers": { "Content-Type": "application/json" },
      "body": { "name": "Test", "email": "[email protected]" },
      "expect_status": 201,
      "expect_json": { "required": ["id", "name"] }
    }
  ]
}