FAQ answers

Általános

Mi az az AstroWay API?

Professionális HTTP API asztrológiai számításokhoz. 714 endpoint a Swiss Ephemeris (WASM) motorján alapul: születési horoszkópok, szinasztria, progressziók, direktciók, tranzitok, Human Design, asztrogeográfia, rektifikáció, AI-alapú interpretációk. Minden számítás a szerveren történik — semmilyen kliensoldali függőség.

Kinek szól ez az API?

Fejlesztőknek, akik asztrológiai alkalmazásokat (web/mobil) építenek, AI-cégeknek, akik asztrológiai funkciókat adnak hozzá termékeikhez, professzionális asztrológusoknak, akik szkripteket használnak, valamint kutatóknak, akik programozott hozzáférést igényelnek a számításokhoz.

Milyen pontosak a számítások?

A Swiss Ephemeris ±1 szögmásodperc pontosságot biztosít a bolygók pozícióira, ±1 szögpercet a házak csúcsaira. Az eredményeket validáltuk az Astrodienst (Astro.com), Solar Fire, Zet 9 és Kepler ellen. Sub-arcsecond drift az NASA JPL ephemeris és az NASA 5-Millennium Eclipse Catalog mellett.

Hogyan hasonlít az AstroWay az Astro.com-hoz vagy a Solar Fire-hez?

Ugyanaz a Swiss Ephemeris motor — ugyanaz, mint a Solar Fire ($495 licenc), Kepler ($995), Astro Gold ($29.99/hó) és az Astrodienst (Astro.com). Validálva az NASA JPL ephemeris és az Astrodienst hivatalos swetest referencia ellen. Sub-arcsecond drift (≤0.1″) a bolygók pozícióiban, ≤1 perc a holdfogyatkozásoknál. A különbség: az AstroWay egy REST API $5/hó-tól, ahelyett, hogy egyszeri licenc vagy asztali GUI lenne.

Mely házrendszerek támogatottak?

15 rendszer: Placidus (alapértelmezett), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentrikus, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC és MC Equal. Add meg a megfelelő kódot a houseSystem paraméterben.

Kreditek és fizetés

Hogyan működik a kreditrendszer?

Minden endpointnak fix kreditköltsége van (10-től 500-ig), a számítás komplexitásától függően. Egyszerű lookup: 10, születési horoszkóp: 20, szinasztria: 50, rektifikáció: 500. A teljes táblázat a Tarifák oldalon található.

Van ingyenes tarifacsomag?

Igen. A Free csomag havi 10 000 kreditet biztosít, 10 req/perc limit mellett. Nincs szükség bankkártya megadására. Elég a termék kipróbálásához és prototípusok készítéséhez.

Mi történik, ha elfogynak a kreditek?

A Free csomag esetén a kérések blokkolva lesznek a következő hónapig (429 CREDITS_EXHAUSTED). Az Indie/Starter/Pro/Business csomagok esetén túllépési díj lép életbe: $5 / $3 / $2 minden további 10 000 kreditért.

Vannak-e gyorsítótárazott kérések?

Igen. Azonos input esetén 5 percen belül a cache-ből visszatérő válasz nem von le krediteket. A X-Cache: HIT fejléc erősíti meg.

Lehet krediteket venni előfizetés nélkül?

Még nem. Az előfizetés előre látható költségvetést és jobb rate limitet biztosít. A Pay-as-you-go tervezés alatt áll.

Technikai

Mely SDK-k érhetők el?

• MCP szerver ✅ kiadva: npx -y @astroway/mcp — minden 714+ endpointot eszközként tesz elérhetővé a Claude $1, Cursor, GPT és más MCP-kompatibilis AI-ügynökök számára
• TypeScript SDK ✅ kiadva: npm install @astroway/sdk — típusok + autocomplete az OpenAPI 3.1 alapján, retry + idempotency, Stainless-stílusú hibák
• Python SDK ✅ kiadva: pip install astroway — szinkron Astroway + aszinkron AsyncAstroway, az httpx alapjain, PEP 561 típusokkal
• PHP SDK ✅ kiadva: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 tervezés alatt — iratkozz fel a értesítésre emailben a(z) /sdk/<language>/ oldalon

Az API szerződés standard REST + JSON, így bármely HTTP-kliens működik SDK nélkül. A Postman collection és az OpenAPI 3.1 spec publikusan elérhető.

Van sandbox mód?

Igen. Az aw_test_* kulcsok nem vonnak le krediteket és ugyanazt az eredményt adják vissza. Ideális fejlesztéshez és teszteléshez.

Milyen rate limitet támogat?

A tarifacsomagtól függ: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1 000 req/perc. Túllépés esetén 429-es hibakóddal, Retry-After fejléccel.

Támogatja a sziderikus zodiákuszt?

Igen. Add át a "zodiacType": "sidereal" és opcionálisan az "ayanamsaId" (alapértelmezett: Lahiri) értéket. Minden endpointon működik.

Mik azok a Human Design endpointok?

12 endpoint a Human Design számításokhoz: típus, stratégia, autoritás, profil, meghatározás, inkarnációs kereszt, csatornák, centrumok, Dream Rave, Hologenetic Profil, Penta (csoportdinamika), időérzékenység. A legmélyebb lefedettség a HD területén a kereskedelmi API-k közül.

Biztonság és adatvédelem

Rögzíti a kérések adatait?

Az API stateless módon működik — a születés dátumának/idejének/koordinátáinak adatai nem kerülnek tárolásra a kérés feldolgozása után. Csak metaadatok kerülnek naplózásra: key_id, endpoint, timestamp, latency, kreditek. Semmilyen személyes adat nem kerül tárolásra.

Megfelel az API a GDPR előírásainak?

Igen. Az adatok nem kerülnek tárolásra. EU-beli felhasználóknak: semmilyen PII feldolgozás, semmilyen profilalkotás, semmilyen cookie. Az API kulcs a fiókhoz van kötve, nem a végfelhasználóhoz.

Biztonságosak az AI-interpretációk?

Az AI-endpointok (/interpret/*, /horoscope/*) beépített biztonsági védőkorlátokkal rendelkeznek: tilos orvosi, jogi vagy pénzügyi tanácsokat adni. Minden válasz tartalmaz egy disclaimer-t. Teljes audit trail áll rendelkezésre enterprise compliance céljából.

Támogatás

Hogyan kaphatok segítséget?

A tarifacsomagtól függ: Free — közösség, Indie — email (48 óra), Starter — email (24 óra), Pro — email (4 óra), Business — email + Slack (1 óra), Enterprise — dedikált menedzser a Slackben. A kapcsolatok a Kapcsolat oldalon találhatók.

Van SLA?

Indie: 99% uptime. Starter és Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: egyedi SLA pénzügyi garanciákkal.