Üzemidő garanciák
| Csomag | Célzott üzemidő | Kárpótlás kreditben megszegés esetén |
|---|---|---|
| Free | garancia nélkül | kárpótlás nélkül |
| Indie | 99 % | 5 % havi díjból minden 0.1 %-ra |
| Starter | 99.9 % | 10 % havi díjból minden 0.1 %-ra |
| Pro | 99.9 % | 25 % havi díjból minden 0.1 %-ra |
| Business | 99.95 % | 50 % havi díjból minden 0.1 %-ra |
| Enterprise | 99.99 % + egyedi | szerződés szerint, írásos SLA |
Az üzemidő a naptári hónapra számítva a https://api.astroway.info/v1/health válaszra, HTTP 200 státusszal 1 000 ms alatt. A tervezett karbantartások (legalább 48 órával előre bejelentve a státuszoldalon) nem számítanak bele.
Célzott késleltetések
Mérések a api.astroway.info/v1/* egy régióból, csak a szerver számítási idejét (a kliens és a hálózat figyelembevétele nélkül). A teljes negyedéves jelentést a státuszoldalon teszünk közzé.
Standard endpointok
Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return és hasonló.
| Metrika | Cél | Valódi (belső mintavételezés, 2026-05-09) |
|---|---|---|
| p50 | < 100 ms | ~80 ms |
| p95 | < 500 ms | ~280 ms |
| p99 | < 1 s | ~640 ms |
Disclaimer: számok valós - belső mintavételezés az api-calc monitorozásból, nyilvános production-telemetry dashboard a roadmapon. Figyelj: p99 = highest extremes, ezért az idő jelentősen magasabb mint a p50.
Nehéz endpointok
Többnapos aggregátorok: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.
| Metrika | Cél | Valódi (2026-04-15) |
|---|---|---|
| p95 | < 2 s | 1.9 s (moon-aspects, 30d) |
| p99 | < 4 s | 1.9 s |
Rektifikáció
POST /v1/rectification (max 120 s) és POST /v1/rectification/trutine (max 15 s) természetüknél fogva hosszúak és nem esnek az SLA késleltetések alá. Tisztelik a Request-Timeout fejlécet 180 s-ig.
Frekvencia korlátozás
Lágy korlátozás a kulcsra a rateLimitMiddleware-ben, HTTP 429-et ad vissza a Retry-After fejlécel.
| Csomag | Kérések / perc | Havi kredit költségvetés |
|---|---|---|
| Free | 10 | 10 000 |
| Indie | 30 | 50 000 |
| Starter | 120 | 200 000 |
| Pro | 400 | 800 000 |
| Business | 1 000 | 3 500 000 |
| Enterprise | custom | korlát nélkül |
A nyilvános sandbox (POST /v1/public/chart) IP alapján korlátozott - 30 kérés / óra, API-kulcs nélkül.
Kérés azonosítása
Minden válasz tartalmazza a X-Request-Id (UUID) fejlécet. Add hozzá, amikor incidensről jelentesz - 30 napig tároljuk az access logokat, és csak egy request-id alapján teljesen rekonstruálhatjuk a hívásod.
HTTP 5xx esetén ugyanaz az azonosító a válasz testében duplikálódik:
{ "ok": false, "error": { "code": "INTERNAL_ERROR", "message": "Internal server error", "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f" }}Incidens reagálás
| Szint | Meghatározás | SLA válasz |
|---|---|---|
| SEV-1 | Minden kérés leáll / regionális hiba | megerősítés 15 perc alatt |
| SEV-2 | Egyedi endpoint hiba vagy >5 % hibák | megerősítés 1 óra alatt |
| SEV-3 | Degradált késleltetés (p95 > 2× cél) | ugyanazon munkanapon |
| SEV-4 | Kozmetikus / egy ügyfél kérdése | következő munkanapon |
Jelents incidenseket a support@astroway.info címre request-id-vel. SEV-1 esetén ellenőrizd a státuszoldalt is.
Verziókezelés és deprecation
- Az endpointok a
/v1/alatt élnek és visszafelé kompatibilisek a fő verzión belül. - Breaking changes a
/v2/alatt jelennek meg, a/v1/pedig ≥ 12 hónapig működik. - Mezők hozzáadása nem breaking; a klienseknek figyelmen kívül kell hagyniuk az ismeretlen mezőket.
- A deprecation a changelog-ben kerül bejelentésre és a fióktulajdonosoknak e-mailben legalább 90 nappal előre értesítést küldünk.
Támogatási csatornák
| Csomag | Csatorna | Válasz |
|---|---|---|
| Free | GitHub issues, community forum | best effort |
| Starter | support@astroway.info | ≤ 1 munkanap |
| Pro | email + prioritásos sor | ≤ 4 munkaóra |
| Enterprise | dedikált Slack / PagerDuty | szerződés szerint |