Service Level Agreement (SLA)

Garantien zur Verfügbarkeit

Tarif	Zielverfügbarkeit	Entschädigung bei Nichteinhaltung als Gutschrift
Free	ohne Garantie	keine Entschädigung
Indie	99 %	5 % der monatlichen Gebühr für jedes 0,1 %
Starter	99,9 %	10 % der monatlichen Gebühr für jedes 0,1 %
Pro	99,9 %	25 % der monatlichen Gebühr für jedes 0,1 %
Business	99,95 %	50 % der monatlichen Gebühr für jedes 0,1 %
Enterprise	99,99 % + custom	nach Vereinbarung, schriftlicher SLA

Die Verfügbarkeit wird pro Kalendermonat anhand der Antwort von https://api.astroway.info/v1/health mit HTTP-Status 200 innerhalb von 1.000 ms gemessen. Geplante Wartungsarbeiten (mindestens 48 Stunden im Voraus angekündigt über die Statusseite) werden nicht in die Berechnung einbezogen.

Zielverzögerungen

Gemessen an api.astroway.info/v1/* aus einer Region, nur die reine Serververarbeitungszeit (ohne Client und Netzwerk). Einen vollständigen Quartalsbericht veröffentlichen wir auf der Statusseite.

Standard-Endpunkte

Chart, Planeten, Synastrie, Transite, Progressionen, ACG, geodätisch, Solar Return und ähnliche.

Metrik	Ziel	Tatsächlich (interne Stichprobe, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Haftungsausschluss: Die tatsächlichen Zahlen sind interne Stichproben aus dem Monitoring von api-calc. Ein öffentlicher Production-Telemetrie-Dashboard ist in der Roadmap. Beachte: p99 = höchste Extremwerte, daher deutlich höher als p50.

Komplexe Endpunkte

Mehrtägige Aggregationen: Transit-Kalender, Forecast-Kalender, Mond-Aspekte, Aspekt-Zeitachse, Gruppen-Synastrie, Finsternis-Analyse.

Metrik	Ziel	Tatsächlich (2026-04-15)
p95	< 2 s	1,9 s (moon-aspects, 30d)
p99	< 4 s	1,9 s

Rektifikation

POST /v1/rectification (bis zu 120 s) und POST /v1/rectification/trutine (bis zu 15 s) sind von Natur aus langlaufend und unterliegen nicht den SLA-Verzögerungsgarantien. Sie respektieren den Header Request-Timeout bis zu 180 s.

Ratenbegrenzung

Weiche Ratenbegrenzung pro Schlüssel in rateLimitMiddleware, gibt HTTP 429 mit Header Retry-After zurück.

Tarif	Anfragen / Minute	Monatliches Guthaben an 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	unbegrenzt

Der öffentliche Sandbox-Endpunkt (POST /v1/public/chart) ist pro IP auf 30 Anfragen/Stunde ohne API-Key begrenzt.

Anfrageidentifikation

Jede Antwort enthält den Header X-Request-Id (UUID). Füge ihn hinzu, wenn du einen Vorfall meldest – wir speichern Access-Logs 30 Tage lang und können mit der Request-ID deinen Aufruf vollständig rekonstruieren.

Bei HTTP 5xx wird dieselbe ID auch im Antworttext dupliziert:

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

Vorfallsmanagement

Stufe	Definition	SLA-Antwortszeit
SEV-1	Alle Anfragen fallen aus / regionaler Ausfall	Bestätigung innerhalb von 15 Minuten
SEV-2	Ausfall eines einzelnen Endpunkts oder >5 % Fehler	Bestätigung innerhalb von 1 Stunde
SEV-3	Degradierte Leistung (p95 > 2× Ziel)	Noch am selben Werktag
SEV-4	Kosmetisches Problem / Frage eines einzelnen Kunden	Noch am nächsten Werktag

Melde Vorfälle an support@astroway.info mit der Request-ID. Bei SEV-1 prüfe zusätzlich die Statusseite.

Versionsverwaltung und Deprecation

Endpunkte leben unter /v1/ und bleiben innerhalb der Hauptversion rückwärtskompatibel.
Breaking Changes werden unter /v2/ veröffentlicht, während /v1/ mindestens 12 Monate weiterläuft.
Das Hinzufügen von Feldern gilt nicht als Breaking Change; Clients sollten unbekannte Felder ignorieren.
Deprecations werden im Changelog angekündigt und mindestens 90 Tage im Voraus per E-Mail an Kontoinhaber gesendet.

Support-Kanäle

Tarif	Kanal	Antwortzeit
Free	GitHub Issues, Community-Forum	nach bestem Ermessen
Starter	`support@astroway.info`	≤ 1 Werktag
Pro	E-Mail + Prioritätswarteschlange	≤ 4 Werktage
Enterprise	Dedizierter Slack / PagerDuty	nach Vertrag

SLA 99.9% uptime