SLA 99.9% uptime

Garanciak a rendelkezésre állás

A rendelkezésre állást a https://api.astroway.info/v1/health endpoint HTTP 200-as válaszának 1000 ms-en belüli válaszideje alapján számoljuk egy naptári hónapra. A tervezett karbantartások (amelyeket legalább 48 órával előre bejelentünk a státuszoldalon) nem számítanak bele a rendelkezésre állás számításába.

Cél válaszidők

A cél válaszidőket az api.astroway.info/v1/* endpointokon egy régióból mérjük, kizárólag a szerver feldolgozási idejét figyelembe véve (a kliens és a hálózat késleltetése nélkül). A teljes negyedéves jelentést a státuszoldalon tesszük közzé.

Standard endpointok

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return és hasonlók.

Disclaimer: Az aktuális számok a belső api-calc monitorozás mintavételei, a publikus production-telemetry dashboard a tervek között van. Fontos megjegyezni, hogy a p99 = a legmagasabb szélsőértékek, ezért jelentősen magasabb lehet a p50-nél.

Nehéz endpointok

Többnapos aggregátumok: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Rektifikáció

A POST /v1/rectification (max. 120 s) és a POST /v1/rectification/trutine (max. 15 s) endpointok természetüknél fogva hosszú futásúak, ezért nem tartoznak a késleltetési SLA hatálya alá. Azonban tiszteletben tartják a Request-Timeout header 180 másodperces értékét.

Kéréskorlátozás

A rateLimitMiddleware enyhe korlátozást alkalmaz a kulcsra, és HTTP 429-es válasszal válaszol, valamint a Retry-After headerrel.

A publikus sandbox (POST /v1/public/chart) IP-címre korlátozott — 30 kérés / óra, API-kulcs nélkül.

Kérésazonosítás

Minden válasz tartalmazza a X-Request-Id (UUID) headerét. Ezt add meg, amikor incidensről értesítesz minket — 30 napig tároljuk az access logokat, és egyetlen kérésazonosító alapján teljesen vissza tudjuk állítani a hívásodat.

HTTP 5xx-es válasz esetén ugyanaz az azonosító megjelenik a válasz törzsében is:

{
  "ok": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f"
  }
}

Incidenskezelés

Incidensekről a support@astroway.info-ra értesíts a request-id-vel. SEV-1 esetében ellenőrizd a státuszoldalt is.

Verziókezelés és elavult funkciók

• Az endpointok a /v1/ alatt vannak, és a fő verzió keretében visszafelé kompatibilisek maradnak.
• A breaking changes a /v2/ alatt jelenik meg, míg a /v1/ legalább 12 hónapig működik.
• Az új mezők hozzáadása nem tekintendő breaking change-nek; a klienseknek figyelmen kívül kell hagyniuk az ismeretlen mezőket.
• Az elavult funkciók bejelentése a changelog-on történik, és a fiókok tulajdonosainak emailben is értesítjük legalább 90 nappal előtte.

Támogatási csatornák