Acordul de nivel de serviciu (SLA)

Garanții de uptime

Plan	Uptime țintă	Compensație cu credite în caz de încălcare
Free	fără garanții	fără compensație
Indie	99 %	5 % din plata lunară pentru fiecare 0.1 %
Starter	99.9 %	10 % din plata lunară pentru fiecare 0.1 %
Pro	99.9 %	25 % din plata lunară pentru fiecare 0.1 %
Business	99.95 %	50 % din plata lunară pentru fiecare 0.1 %
Enterprise	99.99 % + custom	conform contractului, SLA scris

Uptime-ul se calculează pe lună calendaristică pe baza răspunsului https://api.astroway.info/v1/health cu status HTTP 200 în decurs de 1 000 ms. Lucrările planificate (anunțate cu cel puțin 48 de ore prin pagina de status) nu se includ în calcul.

Întârzieri țintă

Se măsoară pe api.astroway.info/v1/* dintr-o singură regiune, doar timpul de calcul pe server (fără a include clientul și rețeaua). Un raport trimestrial complet publicăm pe pagina de status.

Endpoint-uri standard

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return și similare.

Metrikă	Țintă	Real (sampling intern, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Notă: valorile reale sunt din sampling intern din monitorizarea api-calc, dashboard-ul de production-telemetry public este în roadmap. Atenție: p99 = cele mai extreme valori, deci timpul este semnificativ mai mare decât p50.

Endpoint-uri grele

Agregate pe mai multe zile: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Metrikă	Țintă	Real (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30d)
p99	< 4 s	1.9 s

Rectificare

POST /v1/rectification (până la 120 s) și POST /v1/rectification/trutine (până la 15 s) sunt în mod natural lungi și nu se supun SLA-urilor de întârziere. Ele respectă antetul Request-Timeout până la 180 s.

Limite de rată

Limită soft pe cheie în rateLimitMiddleware, returnează HTTP 429 cu antetul Retry-After.

Plan	Cereri / minut	Buget lunar de credite
Free	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	custom	fără limită

Sandbox-ul public (POST /v1/public/chart) este limitat pe IP - 30 cereri / oră, fără cheie API.

Identificarea cererii

Fiecare răspuns conține antetul X-Request-Id (UUID). Adaugă-l când raportezi un incident - păstrăm log-uri de acces 30 de zile și cu un singur request-id putem recrea complet apelul tău.

La HTTP 5xx, același identificator este duplicat în corpul răspunsului:

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

Răspuns la incidente

Nivel	Definiție	SLA de răspuns
SEV-1	Toate cererile eșuează / întrerupere regională	confirmare în 15 min
SEV-2	Eșec al unui endpoint individual sau >5% erori	confirmare în 1 oră
SEV-3	Întârziere degradată (p95 > 2× ținta)	în aceeași zi lucrătoare
SEV-4	Cosmetic / problemă a unui singur client	în ziua lucrătoare următoare

Raportează incidentele la support@astroway.info cu request-id. Pentru SEV-1 verifică și pagina de status.

Versiune și deprecere

Endpoint-urile trăiesc sub /v1/ și rămân compatibile invers în cadrul versiunii majore.
Schimbările majore apar sub /v2/, iar /v1/ continuă să funcționeze ≥ 12 luni.
Adăugarea de câmpuri nu se consideră breaking; clienții trebuie să ignore câmpurile necunoscute.
Deprecerea este anunțată în changelog și este trimisă prin email proprietarilor de cont cu cel puțin 90 de zile înainte.

Canale de suport

Plan	Canal	Răspuns
Free	GitHub issues, forum comunitate	best effort
Starter	`support@astroway.info`	≤ 1 zi lucrătoare
Pro	email + coadă prioritară	≤ 4 ore lucrătoare
Enterprise	Slack dedicat / PagerDuty	conform contractului

SLA 99.9% uptime