Acordul de nivel de serviciu (SLA)

Garanții uptime

Plan	Uptime țintă	Compensare prin credite la încălcare
Free	fără garanții	fără compensare
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 este calculat pentru fiecare lună calendaristică pe baza răspunsului de la https://api.astroway.info/v1/health cu un status HTTP 200 în mai puțin de 1 000 ms. Lucrările planificate (anunțate cu cel puțin 48 de ore înainte pe pagina de status) nu sunt incluse în calcul.

Întârzieri țintă

Măsurate pe api.astroway.info/v1/* dintr-o singură regiune, luând în considerare doar timpul de calcul pe server (fără a lua în calcul clientul și rețeaua). Raportul complet pe un trimestru este publicat pe pagina de status.

Endpoint-uri standard

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return și altele asemănătoare.

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

Disclaimer: valorile reale sunt bazate pe eșantionarea internă din monitorizarea api-calc, dashboard-ul public de telemetrie production este în roadmap. Reține că p99 = cele mai mari extreme, deci timpul este semnificativ mai mare decât p50.

Endpoint-uri complexe

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

Metrică	Țintă	Real (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30z)
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, prin natura lor, procese lungi și nu sunt acoperite de SLA-ul pentru întârzieri. Ele respectă header-ul Request-Timeout până la 180 s.

Limitări de rată

Limitare ușoară pe cheie în rateLimitMiddleware, returnează HTTP 429 cu header-ul 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 de cereri / oră, fără cheie API.

Identificarea cererii

Fiecare răspuns include header-ul X-Request-Id (UUID). Adaugă-l când raportezi un incident — păstrăm logs-urile de acces timp de 30 de zile și, folosind doar request-id-ul, putem reproduce complet apelul tău.

Pentru 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	Definire	SLA răspuns
SEV-1	Toate cererile eșuează / defect regional	confirmare în 15 min
SEV-2	Defect al unui endpoint sau >5 % erori	confirmare în 1 oră
SEV-3	Întârziere degradată (p95 > 2× țintă)	în aceeași zi lucrătoare
SEV-4	Problemă cosmetică / întrebare a unui client	ziua următoare lucrătoare

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

Versiune și deprecieri

Endpoint-urile sunt sub /v1/ și rămân compatibile retroactiv în cadrul aceleiași versiuni majore.
Modificările care rup compatibilitatea (breaking changes) vor fi lansate sub /v2/, iar /v1/ va continua să funcționeze cel puțin 12 luni.
Adăugarea de câmpuri nu este considerată o schimbare care rupe compatibilitatea; clienții trebuie să ignore câmpurile necunoscute.
Deprecierile sunt anunțate în changelog și trimise pe email proprietarilor de conturi cu cel puțin 90 de zile înainte.

Canale de suport

Plan	Canal	Răspuns
Free	Probleme GitHub, 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