Backend API
Inceptor ships an opt-in self-hosted backend in two
interchangeable archetypes — server-node/
(Hono + Zod) and server-flask/
(Flask + Pydantic) — exposing the identical /api/*
contract below. See
the backend guide
and ADR 0006.
Static mode. No
PUBLIC_API_BASE is set, so forms run in
demo mode and the GitHub islands hit api.github.com
directly. Run a server (docker compose --profile backend up)
and set PUBLIC_API_BASE to activate it.
Endpoints
- GET /api/health Liveness probe.
- POST /api/contact Validate (shared schema) + deliver the contact form.
- POST /api/newsletter Validate + deliver a newsletter signup.
- GET /api/issues Token-backed GitHub issues proxy (PRs filtered, no 60 req/h cap).
- GET /api/repo-stats Repo stars / forks / open issues.
- POST /api/feedback Create a real GitHub issue server-side (503 without a token).
- GET /api/openapi.json OpenAPI 3.1, generated from the schemas.
- GET /api/docs Swagger UI.