ff

add-on/AgentPlatform/sts-spec-driven/templates/piatto/API.md

@@ -0,0 +1,30 @@
+# 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 --> | | | | |