/
CrowdVision · source-available, not open source · © 2026 Nicolò Ghignatti
Every service’s HTTP surface, as an OpenAPI 3 document rendered by Swagger UI. The specs are sources in this repository, at api/*.yaml, and are published alongside this guide — so a spec change ships in the same commit as the handler it describes. They document the edge-facing surface only: internal service-to-service hops and cross-boundary payload shapes are contracts in schemas/, not public APIs.
| Spec | Covers |
|---|---|
| Auth Service API | claims-gateway: Keycloak token exchange, the internal RS256 JWT, /verify for the edge. |
| Twin Service API | digital-twin: building upload, provisioning status, per-domain reads. |
| Telemetry Service API | telemetry: batch ingest, thresholds, device actions. |
| Notification Service API | notification: alert delivery and Web Push subscriptions. |
| Contracts Service API | The per-service metric catalogs the dashboard reads. |
| Common Error Responses | The shared error shape every service returns, referenced by the specs above. |