Az AstroWay API elindítása: teljes asztrológiai számítási stack a Swiss Ephemeris pontosságával

Ebben a cikkben — hogy mi van valójában az API-ban, milyen nem szokványos döntéseket hoztunk, mit hagytunk szándékosan ki, és hogyan jutottunk idáig. Víz nélkül.

🕓 Bejegyzés dátuma: 2026-04-22, frissítve: 2026-05-09. Néhány adat elavult. Aktuális állapot: 723 endpoint (nem 87 a bejelentéskor), 818 CI snapshot-teszt (nem 183), az MCP-szerver @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk mostantól a nyilvános regisztrációkon érhető el. A friss státusz: /faq és changelog.

REST API Swiss Ephemeris (LGPL) bázison, WASM-ben fordítva és Node.js-szerverként telepítve — immár AI-értelmezésekkel (failover-lánc: GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) a valós számítások tetején. Ugyanaz a motor, amit a professzionális asztrológusok 30+ éve használnak a Solar Fire, Kepler, Astro Gold és Janus programokban — szögpontosság a szögmásodperc törtrészéig, összevetve a NASA JPL efemeridáival és az Astrodienst hivatalos swetest referenciaeredményeivel (Astro.com).

Adatok:

• 723 endpoint — nyugati natal asztrológia, szinasztría, tranzitok, progressziók, direkciók, visszatérések, harmonikusok, állócsillagok, arab pontok, asztrokartográfia, plusz a teljes Human Design készlet
• 183 snapshot-teszt a CI-ben a valós swetest CGI kimenet és a NASA fogyatkozási katalógusa ellen — minden PR-n lefut
• p50 < 100 ms, p95 < 500 ms tipikus számítási endpointok esetén
• MCP-szerver @astroway/mcp + három SDK a nyilvános regisztrációkon: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — ugyanaz az API három nyelven
• MCP-szerver: @astroway/mcp — az API-t eszközként szolgáltatja Claude, GPT, Cursor és más LLM-ügynökök számára
• Kredit-alapú tarifák: ingyenes terv (10 000 kredit/hónap, kártya nélkül), fizetős — 5 $/hónap-tól

Teljes dokumentáció: api.astroway.info/docs/api/. Aktuális státusz: api.astroway.info/status.

Három évvel ezelőtt asztrológiai fogyasztói alkalmazásokat kezdtünk építeni. A számítási réteg a legnehezebb résznek bizonyult — sokkal bonyolultabb volt, mint a UI vagy a tartalom. A létező szolgáltatások vagy:

1. Felületes lefedettséggel rendelkeztek (10–30 endpoint, főleg csak natal)
2. Drágák voltak nagy volumen esetén ($0,02–$0,10 kérésenként nagy tételek nélkül)
3. Zárt motorokat használtak, amelyek pontosságát nem lehetett ellenőrizni
4. A védikus asztrológiára összpontosítottak, a nyugati asztrológiát másodlagosnak tekintették

Ezért mi magunk vendoroltuk a Swiss Ephemerist és írtuk meg a saját számítási rétegünket — először a app.astroway.info fogyasztói termékhez, majd a astroway.info marketingoldalhoz, amely napi horoszkópokat szolgáltat százezreknek havonta.

Három év termékes működés után két következtetésre jutottunk:

1. Ugyanazt a számítási motort más fejlesztők számára is elérhetővé kell tenni — nem azért, mert ők nem tudnák megírni, hanem mert a könyvtár + WASM + gyorsítótár + CI a pontosságért fél évnyi munka, amit senkinek sem érdemes újra megírni.
2. A Human Design lefedettségünk (12 endpoint — térkép, típus, autoritás, profil, kapuk, csatornák, körvonalak, planetáris aktivációk, inkarnációs kereszt, definíció) valóban egyedi. Egyetlen versenytárs sem kínál teljes HD-stacket API-n keresztül.

Ennek a bejelentésnek a lényege.

Van /nakshatras, /ashtakavarga és divisionális térképek endpointjaink, de nincs Dasha, Panchang, Ashtakoota, KP. Ennek oka: a védikus asztrológiában megoldatlan viták vannak az iskolák között (ayanaṃśa-viták, KP-kuspid-viták, iskola-választás Dashában). Egy sietve összeállított védikus rész a Prokerala vagy VedicAstroAPI ellenében egyszerűen kritika tárgyává vált volna.

A döntés rögzítve: a védikus csomag a 3. fázis része, miután stabil kereslet lesz a nyugati részre, és lesz idő a validálásra a Jagannatha Hora és a Parashara’s Light ellenében. Jobb nem elindítani egyáltalán, mint rosszul elindítani.

Egy /chart hívás számítási igénye ~50-szer kisebb, mint egy 365 napos /forecast-calendar. Egy lapos kérésenkénti ár kiszorítaná a könnyű felhasználókat, vagy támogatná a nehezeket. A kreditek a valós munka költségéhez vannak igazítva — lásd az endpointonkénti táblázatot a tarifaelőfizetési oldalon.

A ingyenes terv válaszai tartalmaznak egy _footer mezőt:

{
  "data": { ... },
  "_footer": "Powered by astroway.api — get your own key at api.astroway.info"
}

Nekünk ez semmit sem kerül, a ingyenes felhasználóknak pedig egy kis ösztönzést ad, hogy frissítsenek. A Hobby+ tervnél a beállításokban eltüntethető. A mintát a Zapier-től és a RevenueCat-től vettük kölcsön.

A /rectification (születési idő meghatározása életesemények alapján likelihood-grid kereséssel) számításigényes: egy hívás 10–60 másodpercig tart és tízezrek számú Swiss Ephemeris köztes számítást végez. Korlátoztuk a Pro tervre ($59/hónap) és nagy kreditárat állítottunk be, mert a visszaélés lerombolta volna a közös infrastruktúrát mindenki más számára.

A /interpret/* endpointjaink egy privát AI-gateway-n keresztül kerülnek routingra, amely a legjobb piaci modellek (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) közül választ failover módban. Nem zárunk be téged a mi prompt designed-jeinkbe — minden értelmezés válasz tartalmazza a kiinduló számításokat, így saját LLM-mel is lecserélheted, ha a mi hangunk nem tetszik. A teljes promptokat és kimeneteket audit-táblázatban naplózzuk B2B-compliance céljából (90 napig történő tárolás).

• Védikus csomag — 3. fázis, miután stabil kereslet mutatkozik (lásd fent)
• Webhookok küszöbérték-értesítésekhez — megvalósítva, de a UI nyers; fejlesztjük
• Publikus widgetek (<script src="api.astroway.info/widget/natal.js">) — 7. fázis
• Plugin a fő marketingoldalhoz — külön projekt, az astroway.info ökoszisztéma keretében tervezve

1. Olvasd el a dokumentációt, ha szeretnéd megérteni a „miértet”: api.astroway.info/overview
2. 5 perces gyorsindítás kóddal: Asztrológiai API gyorsindítás
3. Tarifák, benne az endpointonkénti kredit táblázattal: api.astroway.info/pricing
4. Regisztrálj — ingyenesen, kártya nélkül: api.astroway.info/dashboard/sign-up

Ha építesz valamit az API-ra — vagy találsz egy hibát, vagy szeretnél egy olyan endpointot, amit még nem kínálunk — írj nekünk. Jobb, ha száz fejlesztőtől hallunk kéréseket, mint ha olyan funkciókat építünk, amiket senki sem használ.

Kérdések, kérések, furcsa edge-case-ek: hello@astroway.info.

A roadmap nyilvános — PRODUCT-PLAN.md — mi készült el, mi lesz következő, mi lett elhalasztva és miért.

Üdvözöllek!