Gwarancje uptime
| Plan | Docelowy uptime | Kompensata kredytami przy naruszeniu |
|---|---|---|
| Free | bez gwarancji | bez rekompensaty |
| Indie | 99 % | 5 % miesięcznej opłaty za każde 0.1 % |
| Starter | 99.9 % | 10 % miesięcznej opłaty za każde 0.1 % |
| Pro | 99.9 % | 25 % miesięcznej opłaty za każde 0.1 % |
| Business | 99.95 % | 50 % miesięcznej opłaty za każde 0.1 % |
| Enterprise | 99.99 % + custom | na podstawie umowy, pisemny SLA |
Uptime jest liczony za kalendarzowy miesiąc na podstawie odpowiedzi https://api.astroway.info/v1/health ze statusem HTTP 200 w ciągu 1 000 ms. Prace planowane (ogłaszamy przynajmniej 48 h wcześniej poprzez stronę statusu) nie są wliczane do obliczeń.
Docelowe opóźnienia
Mierzone na api.astroway.info/v1/* z jednego regionu, tylko czas serwera (bez uwzględnienia klienta i sieci). Pełny kwartalny raport publikujemy na stronie statusu.
Standardowe endpointy
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return i podobne.
| Metryka | Cel | Rzeczywiście (wewnętrzny sampling, 2026-05-09) |
|---|---|---|
| p50 | < 100 ms | ~80 ms |
| p95 | < 500 ms | ~280 ms |
| p99 | < 1 s | ~640 ms |
Disclaimer: liczby rzeczywiste - wewnętrzny sampling z monitoringu api-calc, publiczny production-telemetry dashboard w roadmap. Zwracam uwagę: p99 = highest extremes, dlatego czas jest znacznie wyższy niż p50.
Ciężkie endpointy
Wielodniowe agregaty: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.
| Metryka | Cel | Rzeczywiście (2026-04-15) |
|---|---|---|
| p95 | < 2 s | 1.9 s (moon-aspects, 30d) |
| p99 | < 4 s | 1.9 s |
Rektyfikacja
POST /v1/rectification (do 120 s) i POST /v1/rectification/trutine (do 15 s) z natury są długotrwałe i nie podlegają SLA opóźnień. Szanują nagłówek Request-Timeout do 180 s.
Ograniczenia częstotliwości
Miękkie ograniczenie na klucz w rateLimitMiddleware, zwraca HTTP 429 z nagłówkiem Retry-After.
| Plan | Zapytania / minuta | Miesięczny budżet kredytów |
|---|---|---|
| Free | 10 | 10 000 |
| Indie | 30 | 50 000 |
| Starter | 120 | 200 000 |
| Pro | 400 | 800 000 |
| Business | 1 000 | 3 500 000 |
| Enterprise | custom | bez limitu |
Publiczny sandbox (POST /v1/public/chart) ograniczony po IP – 30 zapytań / godzinę, bez klucza API.
Identyfikacja zapytania
Każda odpowiedź zawiera nagłówek X-Request-Id (UUID). Dodaj go, gdy zgłaszasz incydent – przechowujemy access-logi 30 dni i tylko na podstawie request-id możemy w pełni odtworzyć twoje wywołanie.
W przypadku HTTP 5xx ten sam identyfikator jest duplikowany w ciele odpowiedzi:
{ "ok": false, "error": { "code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f" }}Reagowanie na incydenty
| Poziom | Definicja | SLA odpowiedzi |
|---|---|---|
| SEV-1 | Wszystkie zapytania padają / awaria regionalna | potwierdzenie w 15 min |
| SEV-2 | Awaria pojedynczego endpointu lub >5 % błędów | potwierdzenie w 1 godz |
| SEV-3 | Zdegradowane opóźnienie (p95 > 2× cel) | tego samego dnia roboczego |
| SEV-4 | Kosmetyczne / pytanie jednego klienta | następnego dnia roboczego |
Zgłaszaj incydenty na support@astroway.info z request-id. Dla SEV-1 sprawdź również stronę statusu.
Wersjonowanie i deprecation
- Endpointy żyją pod
/v1/i pozostają wstecznie kompatybilne w ramach głównej wersji. - Breaking changes pojawiają się pod
/v2/, a/v1/działa dalej ≥ 12 miesięcy. - Dodawanie pól nie jest breaking; klienci powinni ignorować nieznane pola.
- Deprecation jest ogłaszane w changelog i wysyłane właścicielom kont e-mailem co najmniej 90 dni wcześniej.
Kanały wsparcia
| Plan | Kanał | Odpowiedź |
|---|---|---|
| Free | GitHub issues, community forum | best effort |
| Starter | support@astroway.info | ≤ 1 dzień roboczy |
| Pro | email + priorytetowa kolejka | ≤ 4 godziny robocze |
| Enterprise | dedykowany Slack / PagerDuty | według umowy |