Accordo sul livello di servizio (SLA)

Garanzie di uptime

Piano	Uptime target	Compensazione con crediti in caso di violazione
Free	senza garanzie	senza compensazione
Indie	99 %	5 % del pagamento mensile per ogni 0.1 %
Starter	99.9 %	10 % del pagamento mensile per ogni 0.1 %
Pro	99.9 %	25 % del pagamento mensile per ogni 0.1 %
Business	99.95 %	50 % del pagamento mensile per ogni 0.1 %
Enterprise	99.99 % + custom	secondo contratto, SLA scritto

L’uptime viene calcolato su base mensile in base alle risposte con codice HTTP 200 entro 1000 ms da https://api.astroway.info/v1/health. Le operazioni pianificate (annunciate almeno 48 ore prima tramite la pagina dello stato) non sono incluse nel calcolo.

Ritardi target

Misurati su api.astroway.info/v1/* da una singola regione, considerando solo il tempo di calcolo lato server (senza includere latenza del client o della rete). Pubblicchiamo un rapporto trimestrale completo sulla pagina dello stato.

Endpoint standard

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return e simili.

Metrica	Target	Effettivo (campionamento interno, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Disclaimer: i dati effettivi sono basati su un campionamento interno del monitoraggio di api-calc. Il dashboard pubblico di telemetria di produzione è in roadmap. Nota: p99 rappresenta gli estremi più alti, quindi il tempo è significativamente superiore a p50.

Endpoint pesanti

Aggregati multi-giorno: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Metrica	Target	Effettivo (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30d)
p99	< 4 s	1.9 s

Rettificazione

POST /v1/rectification (fino a 120 s) e POST /v1/rectification/trutine (fino a 15 s) sono per loro natura operazioni lunghe e non rientrano nelle garanzie di latenza SLA. Rispettano l’intestazione Request-Timeout fino a 180 s.

Limitazioni di frequenza

Limite soft per chiave in rateLimitMiddleware, restituisce HTTP 429 con intestazione Retry-After.

Piano	Richieste / minuto	Budget mensile di crediti
Free	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	custom	senza limiti

La sandbox pubblica (POST /v1/public/chart) è limitata per IP — 30 richieste / ora, senza chiave API.

Identificazione della richiesta

Ogni risposta include l’intestazione X-Request-Id (UUID). Includilo quando segnali un incidente: conserviamo i log di accesso per 30 giorni e possiamo ricostruire completamente la tua chiamata solo con l’ID della richiesta.

In caso di errore HTTP 5xx, lo stesso identificatore viene duplicato nel body della risposta:

{
  "ok": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f"
  }
}

Gestione degli incidenti

Livello	Definizione	SLA di risposta
SEV-1	Tutti i endpoint falliscono / guasto regionale	conferma entro 15 min
SEV-2	Guasto di un singolo endpoint o >5 % di errori	conferma entro 1 ora
SEV-3	Latenza degradata (p95 > 2× target)	entro lo stesso giorno lavorativo
SEV-4	Problema estetico / problema di un singolo cliente	entro il giorno lavorativo successivo

Segnala gli incidenti a support@astroway.info includendo l’ID della richiesta. Per SEV-1, controlla anche la pagina dello stato.

Versionamento e deprecazione

Gli endpoint vivono sotto /v1/ e rimangono retrocompatibili entro la stessa versione principale.
Le modifiche breaking vengono rilasciate sotto /v2/, mentre /v1/ continua a funzionare per ≥ 12 mesi.
L’aggiunta di campi non è considerata una modifica breaking; i client devono ignorare i campi sconosciuti.
La deprecazione viene annunciata nel changelog e inviata ai proprietari degli account via email almeno 90 giorni prima.

Canali di supporto

Piano	Canale	Risposta
Free	GitHub issues, forum della community	best effort
Starter	`support@astroway.info`	≤ 1 giorno lavorativo
Pro	email + coda prioritaria	≤ 4 ore lavorative
Enterprise	Slack / PagerDuty dedicato	secondo contratto

SLA 99.9% uptime