Accordo sul livello di servizio (SLA)

Garanzia di uptime

Piano	Target uptime	Compensazione in crediti per 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	su contratto, SLA scritto

L’uptime viene calcolato su base mensile in base alla risposta https://api.astroway.info/v1/health con stato HTTP 200 entro 1 000 ms. I lavori pianificati (annunciati con almeno 48 ore di anticipo attraverso la pagina di stato) non sono inclusi nel calcolo.

Tempi di risposta target

Vengono misurati su api.astroway.info/v1/* da una singola regione, solo tempo di calcolo del server (escluso client e rete). Pubblichiamo un report trimestrale completo sulla pagina di stato.

Endpoint standard

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

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

Disclaimer: i valori attuali sono da campionamento interno del monitoraggio api-calc, il dashboard di production-telemetry pubblico è in roadmap. Attenzione: p99 = estremi più alti, quindi il tempo è significativamente superiore a p50.

Endpoint complessi

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

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

Rettifica

POST /v1/rectification (fino a 120 s) e POST /v1/rectification/trutine (fino a 15 s) sono per natura operazioni lunghe e non soggette a SLA sui tempi. Rispettano l’header Request-Timeout fino a 180 s.

Limiti di frequenza

Limite soft per chiave in rateLimitMiddleware, restituisce HTTP 429 con header 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 limite

Il sandbox pubblico (POST /v1/public/chart) è limitato per IP - 30 richieste / ora, senza chiave API.

Identificazione della richiesta

Ogni risposta contiene l’header X-Request-Id (UUID). Aggiungilo quando segui un incidente - conserviamo i log di accesso per 30 giorni e con un solo request-id possiamo riprodurre completamente la tua chiamata.

Su HTTP 5xx lo stesso identificatore viene duplicato nel corpo della risposta:

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

Risposta agli incidenti

Livello	Definizione	SLA di risposta
SEV-1	Tutte le richieste falliscono / guasto regionale	conferma entro 15 min
SEV-2	Guardo di un singolo endpoint o >5% errori	conferma entro 1 ora
SEV-3	Ritardo degradato (p95 > 2× target)	stesso giorno lavorativo
SEV-4	Cosmetico / problema di un singolo cliente	giorno lavorativo successivo

Segnala gli incidenti a support@astroway.info con request-id. Per SEV-1 controlla anche la pagina di stato.

Versionamento e deprecation

Gli endpoint vivono sotto /v1/ e rimangono compatibili all’indietro all’interno della versione principale.
Le modifiche breaking arrivano sotto /v2/, mentre /v1/ continua a funzionare per ≥ 12 mesi.
L’aggiunta di campi non è considerata breaking; i client devono ignorare i campi sconosciuti.
La deprecation viene annunciata nel changelog e inviata via email ai proprietari di account almeno 90 giorni prima.

Canali di supporto

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

SLA 99.9% uptime