# API — {{PROGETTO}} Ultimo aggiornamento: **{{DATA}}** Il contratto si scrive **prima** del codice. Se esiste un `openapi.yaml`, quello è la fonte di verità. ## Convenzioni | Aspetto | Regola | |---|---| | Prefisso | `/api/v1` | | Formato | JSON, UTF-8, date ISO 8601 UTC | | Autenticazione | | | Errori | `{ "error": { "code", "message", "details" } }` | ## Endpoint — Stato di servizio ### `GET /health` *(pubblico)* Risponde `200 {"status": "ok"}`. ## Endpoint previsti ### — *(previsto)* | Metodo | Percorso | Ruolo minimo | Descrizione | Task | |---|---|---|---|---| | | | | | |