| name | web-api-tester |
| description | Test API endpoints for correctness, edge cases, auth handling, and OpenAPI contract compliance. |
| compatibility | codex, claude-code, claude-ai, agent-skills |
| license | Apache-2.0 |
| allowed-tools | ["read_file","write_file","run_terminal_cmd","web_search"] |
| metadata | {"category":"web-builder","stage":"7-api-testing","pipeline":"web-builder"} |
Web API Tester
Objective
Run endpoint-level testing against openapi.yaml and produce API quality
coverage artifacts.
Required Workflow
- Read
openapi.yaml from web-backend-builder.
- Build API collections for Bruno or Hoppscotch.
- Optionally generate automated tests in Vitest, Jest, or pytest.
- For each endpoint test:
- happy path
- edge cases (missing fields, invalid types, max payloads)
- auth failures (
401, 403)
- rate limiting behavior
- Validate response contracts against OpenAPI using Zod (TS) or Pydantic (Python).
- Add frontend-backend contract tests for API call compatibility.
- Generate endpoint and edge-case coverage percentages.
- Output
api-test-report.json.
Execution
python skills/web-api-tester/scripts/api_tester.py --input <workspace> --output <out.json> --format json
References