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

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