FAQ answers

Általános

Mi az AstroWay API?

Professzionális HTTP API asztrológiai számításokhoz. 771 endpoint a Swiss Ephemeris alapjával: születési képletek, szinasztria, progressziók, direkciók, tranzitok, Human Design, asztrokartográfia, rektifikáció, AI-értelmezések. Minden számítás a szerveren történik – nincs kliensoldali függőség.

Kinek szól ez az API?

Fejlesztőknek, akik asztrológiai alkalmazásokat (web/mobile) építenek, AI cégeknek, amelyek asztrológiai funkciókat adnak hozzá, professzionális asztrológusoknak szkriptekkel, és kutatóknak, akiknek programozott hozzáférésre van szükségük a számításokhoz.

Milyen pontosságúak a számítások?

A Swiss Ephemeris ±1 ívmásodperc pontosságú bolygópozíciókat biztosít, a házcsúcsok ±1 ívmásodperc pontosságúak. Az eredményeket ellenőrizték az Astrodienst (Astro.com), Solar Fire, Zet 9 és Kepler ellen. Sub-arcsecond drift a NASA JPL ephemeris és a NASA 5-Millennium Eclipse Catalog ellen.

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

Azonos Swiss Ephemeris motor – ugyanaz, mint a Solar Fire‑ben ($495 licenc), Kepler‑ben ($995), Astro Gold‑ban ($29.99/hó) és az Astrodienst‑ben (Astro.com). Validálva a NASA JPL ephemeris és az Astrodienst hivatalos swetest referencia ellen. Sub-arcsecond drift (≤0.1″) a bolygópozícióknál, ≤1 perc az elhalálozásoknál. Különbség: AstroWay – REST API $5/міс helyett egyszeri licenc vagy asztali GUI.

Milyen házrendszerek támogatottak?

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

Kredit és fizetés

Hogyan működik a kredit rendszer?

Minden endpointnek fix kredit költsége van (10‑500 kredit) a számítás bonyolultságától függően. Egyszerű lookup – 10, születési képlet – 20, szinasztria – 50, rektifikáció – 500. A teljes táblázat a Tarifák oldalon.

Van ingyenes csomag?

Igen. A Free csomag 10 000 kreditet/hó és 10 req/min biztosít. Kártya megadása nélkül. Elég a termék kipróbálásához és prototípus készítéséhez.

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

Free esetén a kérések blokkolva vannak a következő hónapig (429 CREDITS_EXHAUSTED). Indie/Starter/Pro/Business esetén overage lép életbe: $5 / $3 / $2 10 000 további kreditért.

Cache-elve vannak az azonos kérések?

Igen. Azonos input 5 percig a cache-ből visszatér kredit levonás nélkül. A X-Cache: HIT fejléc jelzi.

Vásárolhatsz krediteket 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. Pay-as-you-go tervezett.

Technikai

Milyen SDK-k érhetők el?

• MCP szerver ✅ megvalósítva: npx -y @astroway/mcp: exponálja az összes 771+ endpointet eszközként a Claude Desktop, Cursor, GPT és más MCP-kompatibilis AI-ügynökök számára
• TypeScript SDK ✅ megvalósítva: npm install @astroway/sdk: típusok + autocomplete az OpenAPI 3.1‑ből, retry + idempotency, Stainless-stílusú hibák
• Python SDK ✅ megvalósítva: pip install astroway: sync Astroway + async AsyncAstroway, a httpx‑en alapul, PEP 561 típusos
• PHP SDK ✅ megvalósítva: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 tervezett: iratkozz fel az e‑mail értesítésre az egyes SDK‑k oldalán (/sdk/<language>/)

Az API szerződés – standard REST + JSON, így bármely HTTP‑klienst használhatsz SDK nélkül. A Postman gyűjtemény és az OpenAPI 3.1 specifikáció nyilvánosan elérhető.

Van sandbox mód?

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

Mi a rate limit?

A csomagtól függ: Free – 10, Indie – 30, Starter – 120, Pro – 400, Business – 1 000 req/min. Túllépés esetén 429 a Retry-After fejlécel.

Támogatott a siderális zodiákus?

Igen. Add meg a "zodiacType": "sidereal"-t és opcionálisan a "ayanamsaId"-t (alapértelmezett – Lahiri). Minden endpointnél működik.

Mik azok a Human Design endpointok?

12 endpoint a Human Design számításához: típus, stratégia, autoritás, profil, definíció, inkarnációs kereszt, csatornák, központok, Dream Rave, Hologenetic Profile, Penta (csoportdinamika), időérzékenység. A legmélyebb HD lefedettség a kereskedelmi API-k között.

Biztonság és adatvédelem

Tárolódnak a kérés adatai?

Az API stateless – a születési dátum/idő/koordináták adatai nem tárolódnak a kérés feldolgozása után. Csak metaadatok naplózódnak: key_id, endpoint, timestamp, latency, kredit. Nincsenek személyes adatok.

Megfelel-e az API a GDPR követelményeinek?

Igen. Az adatokat nem tároljuk. EU‑beli felhasználók esetén: nincs PII feldolgozás, nincs profilalkotás, nincs cookie. Az API kulcs a fiókhoz van kötve, nem a végfelhasználóhoz.

Biztonságosak-e az AI-értelmezések?

Az AI endpointok (/interpret/*, /horoscope/*) beépített safety guardrails‑szel rendelkeznek: tilos orvosi, jogi, pénzügyi tanácsot adni. Minden válasz tartalmaz disclaimer‑t. Teljes audit trail – vállalati megfeleléshez.

Támogatás

Hogyan kaphatsz segítséget?

A csomagtól függ: Free – közösség, Indie – e‑mail (48 óra), Starter – e‑mail (24 óra), Pro – e‑mail (4 óra), Business – e‑mail + Slack (1 óra), Enterprise – dedikált menedzser a Slack‑en. Kapcsolatok a Kapcsolatok oldalon.

Van SLA?

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

Hasonló nevek

Kapcsolódik-e az AstroWay API (astroway.info) az astroway.life által kínált “Astroway” előfizetéshez?

Nem. astroway.info és api.astroway.info – egy külön, független cég. Mi asztrológiai API‑t biztosítunk fejlesztőknek (api.astroway.info), felhasználói alkalmazást (app.astroway.info) és asztrológiai konzultációt. Nincs semmilyen kapcsolatunk a fogyasztói asztrológiai előfizetéshez, amelyet a astroway.life hirdet és “Astroway” néven terhel (levelek a no-reply@astroway.life‑tól, személy “Celeste”, a bankszámlakivonaton – “Astroway”). Ennek az előfizetésnek az üzemeltetője a TrafficLeader OÜ (Észtország, valamint traffic-leader.com); a kapcsolódó bérbeadó SKYREAD.PRO – a ABCMobile OÜ (Észtország). Csak a név hasonló hangzása egyezik – különböző cégek.

Levonják tőlem az “Astroway” díjat – hogyan mondjam le az előfizetést és kapjak visszatérítést?

Ha levonják tőled az “Astroway” előfizetés díját (levelek a no-reply@astroway.life‑tól, a bankszámlakivonaton – “Astroway”), az egy másik cég, astroway.life, nem mi vagyunk. Nincs hozzáférésünk a fiókodhoz vagy a fizetéseidhez ebben a szolgáltatásban, így nem tudjuk lemondani vagy visszatéríteni őket. Teendők:

1. Válaszolj közvetlenül a no-reply@astroway.life levélre, és használd a láblécben található “leiratkozás / lemondás” linket.
2. Ha nem reagálnak: fordulj a saját bankodhoz vagy a kártyakibocsátóhoz (a fizetés a kivonaton – “Astroway”; kereskedő – TrafficLeader OÜ vagy ABCMobile OÜ / SKYREAD.PRO, Észtország) és kérd a további levonások blokkolását vagy a visszatérítést (chargeback).