Záruky uptime
| Plán | Cílový uptime | 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 | podle smlouvy, písemný SLA |
Uptime se počítá za kalendářní měsíc podle odpovědi https://api.astroway.info/v1/health se statusem HTTP 200 během 1 000 ms. Plánované práce (oznamujeme je nejméně 48 h předem přes statusní stránku) se do výpočtu nezapočítávají.
Cílové latence
Měří se na api.astroway.info/v1/* z jednoho regionu, pouze serverový výpočetní čas (bez započítání klienta a sítě). Kompletní čtvrtletní zprávu publikujeme na statusní stránce.
Standardní endpointy
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return a podobné.
| Metrika | Cíl | Skutečně (interní sampling, 2026-05-09) |
|---|---|---|
| p50 | < 100 ms | ~80 ms |
| p95 | < 500 ms | ~280 ms |
| p99 | < 1 s | ~640 ms |
Disclaimer: čísla jsou skutečná – interní sampling z monitoringu api-calc, veřejný production-telemetry dashboard v roadmapě. Všimni si: p99 = highest extremes, takže čas je výrazně vyšší než p50.
Náročné endpointy
Vícedenní agregáty: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.
| Metrika | Cíl | Skutečně (2026-04-15) |
|---|---|---|
| p95 | < 2 s | 1.9 s (moon-aspects, 30d) |
| p99 | < 4 s | 1.9 s |
Rectifikace
POST /v1/rectification (až 120 s) a POST /v1/rectification/trutine (až 15 s) jsou ze své podstaty dlouhodobé a nespadají pod SLA latencí. Respektují hlavičku Request-Timeout až do 180 s.
Omezení rychlosti
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 jen pomocí request-id můžeme plně reprodukovat tvé volání.
U HTTP 5xx se stejný identifikátor duplikuje 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 odpovědi |
|---|---|---|
| SEV-1 | Všechny požadavky selhávají / regionální výpadek | potvrzení do 15 min |
| SEV-2 | Selhání konkrétního endpointu nebo >5 % chyb | potvrzení do 1 h |
| SEV-3 | Degradovaná latence (p95 > 2× cíle) | toho samého pracovního dne |
| SEV-4 | Kosmetické / otázka jednoho klienta | následujícího pracovního dne |
Hlásit incidenty na support@astroway.info s request-id. Pro SEV-1 také zkontroluj statusní stránku.
Verzování a deprecation
- Endpointy žijí pod
/v1/a zůstávají zpětně kompatibilní v rámci hlavní verze. - Breaking changes přicházejí pod
/v2/, a/v1/pokračuje fungovat ≥ 12 měsíců. - Přidání polí se nepovažuje za breaking; klienti by měli ignorovat neznámá pole.
- Deprecation je oznámena v changelog a zasílána majitelům účtů e-mailem nejméně 90 dní předem.
Kanály podpory
| Plán | Kanál | Odpověď |
|---|---|---|
| Free | GitHub issues, community forum | best effort |
| Starter | support@astroway.info | ≤ 1 pracovní den |
| Pro | email + prioritní fronta | ≤ 4 pracovní hodiny |
| Enterprise | vyhrazený Slack / PagerDuty | za kontraktem |