http-api-openapi

Tooling assumptions

• Use a terminal runner with bash and git available.
• Prefer make targets when available; fall back to direct CLI commands when needed.

Source of truth

• OpenAPI spec: openapi.yaml at the repo root.

Typical workflow

1. Update openapi.yaml (paths, schemas, auth).
2. Validate the spec:

make validate-openapi

If swagger-cli isn’t installed:

npm install -g @apidevtools/swagger-cli

3. Implement the handler changes in Go (and keep auth consistent with the spec).
4. Run tests:

make test

Project-specific notes

• Authenticated endpoints use Bearer token auth (see README’s Auth section).
• Be explicit about error responses and status codes in the spec when behavior changes.