Záruky dostupnosti
| Plán | Cílová dostupnost | Kompenzace kredity při porušení |
|---|---|---|
| Free | bez záruk | bez kompenzace |
| Indie | 99 % | 5 % měsíční platby za každých 0,1 % |
| Starter | 99,9 % | 10 % měsíční platby za každých 0,1 % |
| Pro | 99,9 % | 25 % měsíční platby za každých 0,1 % |
| Business | 99,95 % | 50 % měsíční platby za každých 0,1 % |
| Enterprise | 99,99 % + custom | dle smlouvy, písemný SLA |
Dostupnost se počítá za kalendářní měsíc podle odpovědi https://api.astroway.info/v1/health se stavem HTTP 200 do 1 000 ms. Plánované práce (oznámené nejméně 48 hodin předem přes stránku stavu) se do výpočtu nezahrnují.
Cílové latence
Měřeno na api.astroway.info/v1/* z jednoho regionu, pouze serverový čas výpočtu (bez klienta a sítě). Úplnou čtvrtletní zprávu publikujeme na stránce stavu.
Standardní endpointy
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return a podobné.
| Metrika | Cíl | Skutečnost (interní sampling, 2026-05-09) |
|---|---|---|
| p50 | < 100 ms | ~80 ms |
| p95 | < 500 ms | ~280 ms |
| p99 | < 1 s | ~640 ms |
Upozornění: čísla ve skutečnosti jsou interním samplingem z monitoringu api-calc, veřejný dashboard produkční telemetrie je ve vývoji. Poznámka: p99 = nejvyšší extrémy, proto je čas výrazně vyšší než p50.
Náročné endpointy
Vícedenní agregace: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.
| Metrika | Cíl | Skutečnost (2026-04-15) |
|---|---|---|
| p95 | < 2 s | 1,9 s (moon-aspects, 30d) |
| p99 | < 4 s | 1,9 s |
Retifikace
POST /v1/rectification (do 120 s) a POST /v1/rectification/trutine (do 15 s) jsou z principu dlouhotrvající a nepodléhají SLA latencí. Respektují hlavičku Request-Timeout až do 180 s.
Omezení frekvence
Měkké omezení na klíč v rateLimitMiddleware, vrací HTTP 429 s hlavičkou Retry-After.
| Plán | Požadavků / minutu | Měsíční rozpočet kreditů |
|---|---|---|
| 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 |
Veřejný sandbox (POST /v1/public/chart) je omezen podle IP – 30 požadavků / hodinu, bez API klíče.
Identifikace požadavku
Každá odpověď obsahuje hlavičku X-Request-Id (UUID). Přidej ji, když hlásíš incident – uchováváme access logy 30 dní a podle jednoho request-id dokážeme tvé volání plně rekonstruovat.
U HTTP 5xx se stejný identifikátor opakuje v těle odpovědi:
{ "ok": false, "error": { "code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f" }}Reakce na incidenty
| Úroveň | Definice | SLA reakce |
|---|---|---|
| SEV-1 | Všechny požadavky padají / regionální výpadek | potvrzení do 15 minut |
| SEV-2 | Výpadek jednoho endpointu nebo >5 % chyb | potvrzení do 1 hodiny |
| SEV-3 | Degradovaná latence (p95 > 2× cíle) | do konce pracovního dne |
| SEV-4 | Kosmetická / dotaz jednoho klienta | do příštího pracovního dne |
Hlaš incidenty na support@astroway.info s request-id. U SEV-1 také zkontroluj stránku stavu.
Verzování a deprekace
- Endpointy běží pod
/v1/a zůstávají zpětně kompatibilní v rámci hlavní verze. - Breaking changes vycházejí pod
/v2/,/v1/běží minimálně 12 měsíců. - Přidání polí se nepovažuje za breaking; klienti mají ignorovat neznámá pole.
- Deprekace se oznámí v changelogu a pošle vlastníkům účtů emailem nejméně 90 dní předem.
Kanály podpory
| Plán | Kanál | Reakce |
|---|---|---|
| Free | GitHub issues, komunitní fórum | best effort |
| Starter | support@astroway.info | ≤ 1 pracovní den |
| Pro | email + prioritní fronta | ≤ 4 pracovní hodiny |
| Enterprise | vyhrazený Slack / PagerDuty | dle smlouvy |