Uptime-Garantien
| Plan | Ziel-Uptime | Kompensation mit Krediten bei Verstoß |
|---|---|---|
| Free | keine Garantie | keine Kompensation |
| Indie | 99 % | 5 % der monatlichen Zahlung für jede 0.1 % |
| Starter | 99.9 % | 10 % der monatlichen Zahlung für jede 0.1 % |
| Pro | 99.9 % | 25 % der monatlichen Zahlung für jede 0.1 % |
| Business | 99.95 % | 50 % der monatlichen Zahlung für jede 0.1 % |
| Enterprise | 99.99 % + custom | nach Vereinbarung, schriftlicher SLA |
Uptime wird pro Kalendermonat anhand der Antwort https://api.astroway.info/v1/health mit HTTP 200 innerhalb von 1 000 ms berechnet. Geplante Wartungen (wir kündigen mindestens 48 Stunden im Voraus über die Statusseite) werden nicht berücksichtigt.
Zielverzögerungen
Gemessen auf api.astroway.info/v1/* aus einer Region, nur die Server‑Rechenzeit (ohne Client‑ und Netzwerk‑Einfluss). Der vollständige Quartalsbericht wird auf der Statusseite veröffentlicht.
Standard‑Endpoints
Chart, planets, synastry, transits, progressions, ACG, geodetic, 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 |
Disclaimer: Die Zahlen sind tatsächlich interne Stichproben aus dem Monitoring von api‑calc, öffentliches Production‑Telemetry‑Dashboard in der Roadmap. Hinweis: p99 = höchste Extreme, daher ist die Zeit deutlich höher als p50.
Aufwändige Endpoints
Mehrtägige Aggregate: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.
| Metrik | Ziel | Tatsächlich (2026-04-15) |
|---|---|---|
| p95 | < 2 s | 1.9 s (moon-aspects, 30d) |
| p99 | < 4 s | 1.9 s |
Rectification
POST /v1/rectification (bis zu 120 s) und POST /v1/rectification/trutine (bis zu 15 s) sind von Natur aus langwierig und fallen nicht unter die SLA‑Verzögerungen. Sie respektieren den Header Request-Timeout bis zu 180 s.
Ratenbegrenzung
Weiche Begrenzung pro Schlüssel in rateLimitMiddleware, gibt HTTP 429 mit dem Header Retry-After zurück.
| Plan | Anfragen / Minute | Monatliches Kreditbudget |
|---|---|---|
| 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 (POST /v1/public/chart) ist IP‑beschränkt – 30 Anfragen pro Stunde, ohne API‑Schlüssel.
Anfrage‑Identifikation
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 und können mit nur der request‑id deinen Aufruf vollständig reproduzieren.
Bei HTTP 5xx wird dieselbe Kennung im Antwort‑Body dupliziert:
{ "ok": false, "error": { "code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f" }}Vorfall‑Reaktion
| Stufe | Definition | SLA‑Antwortzeit |
|---|---|---|
| SEV-1 | Alle Anfragen fallen aus / regionaler Ausfall | Bestätigung innerhalb von 15 Minuten |
| SEV-2 | Ausfall eines einzelnen Endpoints oder >5 % Fehler | Bestätigung innerhalb von 1 Stunde |
| SEV-3 | Degradierte Verzögerung (p95 > 2× Ziel) | am selben Arbeitstag |
| SEV-4 | Kleinigkeiten / Frage eines einzelnen Kunden | am nächsten Arbeitstag |
Melde Vorfälle an support@astroway.info mit der request‑id. Für SEV‑1 prüfe zusätzlich die Statusseite.
Versionierung und Deprecation
- Endpoints leben unter
/v1/und bleiben innerhalb der Hauptversion rückwärtskompatibel. - Breaking Changes erscheinen unter
/v2/, und/v1/bleibt ≥ 12 Monate funktionsfähig. - Das Hinzufügen von Feldern gilt nicht als breaking; Clients sollten unbekannte Felder ignorieren.
- Deprecation wird im Changelog angekündigt und mindestens 90 Tage vorab per E‑Mail an Kontoinhaber gesendet.
Support‑Kanäle
| Plan | Kanal | Antwort |
|---|---|---|
| Free | GitHub issues, community forum | best effort |
| Starter | support@astroway.info | ≤ 1 Arbeitstag |
| Pro | E‑Mail + Prioritätswarteschlange | ≤ 4 Arbeitsstunden |
| Enterprise | dedizierter Slack / PagerDuty | nach Vertrag |