31 lines
758 B
Markdown
31 lines
758 B
Markdown
# 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 | <!-- DA COMPILARE --> |
|
|
| Errori | `{ "error": { "code", "message", "details" } }` |
|
|
|
|
## Endpoint — Stato di servizio
|
|
|
|
### `GET /health` *(pubblico)*
|
|
|
|
Risponde `200 {"status": "ok"}`.
|
|
|
|
## Endpoint previsti
|
|
|
|
<!-- Un gruppo per modulo. Stato nel titolo: *(previsto)* · ✅ *implementato (T-xxx)*. -->
|
|
|
|
### <!-- Gruppo --> — *(previsto)*
|
|
|
|
| Metodo | Percorso | Ruolo minimo | Descrizione | Task |
|
|
|---|---|---|---|---|
|
|
| <!-- DA COMPILARE --> | | | | |
|