14 API Development and operations Low

API-First Development — OpenAPI to Production

Endpoint implementation from OpenAPI spec with automatic verification via schemathesis.

◻ intake ★★★

△ architect ★★★

◇ vigil ★★☆

⬡ licit ★☆☆

Context

API-first development where the OpenAPI spec is the source of truth. intake normalizes, architect implements with schemathesis as check, and vigil verifies route security.

Flow with 4 tools

◻ Phase 01 — intake

OpenAPI as spec

Normalizes OpenAPI spec and Jira tickets into architect format.

◻ intake

intake init "User Management API v2" \
  --source api/openapi-users-v2.yaml \
  --source jira://API/sprint-12 \
  --format architect

△ Phase 02 — architect

Endpoint implementation

Loop with schemathesis and vigil as checks.

△ architect

architect loop "Implement endpoints per OpenAPI spec" \
  --check "schemathesis run api/openapi-users-v2.yaml --base-url http://localhost:8000" \
  --check "vigil scan src/routes/" \
  --max-iterations 20