Service Level Agreement (SLA)

Garanties voor uptime

Plan	Streefwaarde uptime	Compensatie bij overschrijding
Free	geen garantie	geen compensatie
Indie	99 %	5 % maandelijkse betaling voor elke 0.1 %
Starter	99.9 %	10 % maandelijkse betaling voor elke 0.1 %
Pro	99.9 %	25 % maandelijkse betaling voor elke 0.1 %
Business	99.95 %	50 % maandelijkse betaling voor elke 0.1 %
Enterprise	99.99 % + custom	volgens contract, schriftelijke SLA

Uptime wordt berekend per kalendermaand op basis van de respons van https://api.astroway.info/v1/health met HTTP-status 200 binnen 1.000 ms. Geplande onderhoudswerkzaamheden (minimaal 48 uur van tevoren aangekondigd via de statuspagina) worden niet meegenomen in de berekening.

Streefwaarden voor latentie

Gemeten op api.astroway.info/v1/* vanuit één regio, alleen de serververwerkingstijd (zonder rekening te houden met de client of netwerk). Een volledig kwartaalrapport publiceren we op de statuspagina.

Standaard endpoints

Chart, planets, synastry, transits, progressions, ACG, geodetisch, solar-return en dergelijke.

Metriek	Streefwaarde	Werkelijk (interne sampling, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Disclaimer: De werkelijke cijfers zijn gebaseerd op interne sampling van de api-calc-monitoring. De publieke productie-telemetriedashboard staat op de roadmap. Let op: p99 = hoogste uitschieters, dus de tijd is aanzienlijk hoger dan p50.

Zware endpoints

Meerdagelijkse aggregaties: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Metriek	Streefwaarde	Werkelijk (2026-04-15)
p95	< 2 s	1,9 s (moon-aspects, 30d)
p99	< 4 s	1,9 s

Rectificatie

POST /v1/rectification (tot 120 s) en POST /v1/rectification/trutine (tot 15 s) zijn van nature langdurig en vallen niet onder de latentie-SLA. Ze respecteren de Request-Timeout-header tot 180 s.

Frequentiebeperkingen

Zacht frequentiebeperking per sleutel in rateLimitMiddleware, retourneert HTTP 429 met de header Retry-After.

Plan	Verzoeken / minuut	Maandbudget aan credits
Free	10	10.000
Indie	30	50.000
Starter	120	200.000
Pro	400	800.000
Business	1.000	3.500.000
Enterprise	custom	geen limiet

De publieke sandbox (POST /v1/public/chart) is beperkt per IP — 30 verzoeken / uur, zonder API-sleutel.

Verzoekidentificatie

Elk antwoord bevat de header X-Request-Id (UUID). Voeg deze toe wanneer je een incident meldt — we slaan access-logs 30 dagen op en kunnen met alleen het request-id je oproep volledig reconstrueren.

Bij HTTP 5xx wordt dezelfde identifier ook in de body van het antwoord gedupliceerd:

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

Incidentrespons

Niveau	Definitie	SLA voor reactie
SEV-1	Alle verzoeken mislukken / regionale storing	bevestiging binnen 15 min
SEV-2	Storing van een specifiek endpoint of >5 % fouten	bevestiging binnen 1 uur
SEV-3	Degradatie latentie (p95 > 2× streefwaarde)	dezelfde werkdag
SEV-4	Cosmetisch / vraag van één klant	volgende werkdag

Meld incidenten via support@astroway.info met het request-id. Voor SEV-1 kun je ook de statuspagina raadplegen.

Versiebeheer en deprecation

Endpoints leven onder /v1/ en blijven achterwaarts compatibel binnen dezelfde hoofdversie.
Breaking changes verschijnen onder /v2/, terwijl /v1/ minimaal 12 maanden actief blijft.
Het toevoegen van velden wordt niet als breaking beschouwd; clients moeten onbekende velden negeren.
Deprecation wordt aangekondigd in de changelog en per e-mail naar account-eigenaren verzonden, minimaal 90 dagen van tevoren.

Ondersteuningskanalen

Plan	Kanaal	Reactietijd
Free	GitHub issues, community forum	best effort
Starter	`support@astroway.info`	≤ 1 werkdag
Pro	e-mail + prioritaire wachtrij	≤ 4 werkuren
Enterprise	toegewijde Slack / PagerDuty	volgens contract

SLA 99.9% uptime