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

Ma bejelentjük a AstroWay API-t – egy számítási backend fejlesztőknek, akik asztrológiai alkalmazásokat, horoszkóp termékeket, kompatibilitási funkciókat a társkereséshez és AI-ügynököket hoznak létre, akiknek a születési képleteket kell elemezniük.

Ebben a cikkben – mi van valójában az API-ban, milyen szokatlan megoldásokat alkalmaztunk, mit hagytunk szándékosan ki, és hogyan jutottunk ide. Felesleges szó nélkül.

🕓 Felvétel 2026-04-22, frissítve 2026-05-09. Néhány szám elavult. Aktuális állapot: 758 endpoint (nem 87 a launch időpontjában), 873 CI snapshot-teszt (nem 183), MCP-szerver @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk most már mind a public registries-on él. Friss státusz - a /faq és a changelog oldalon.

REST API a Swiss Ephemeris (LGPL) alapján, WASM-be lefordítva és Node.js-szolgáltatásként üzemeltetve – most már AI-értelmezésekkel is (failover-lánc GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) a valós számítások felett. Ugyanaz a motor, amelyet a professzionális asztrológusok 30+ éve használnak a Solar Fire, Kepler, Astro Gold és Janus programokban – szögmásodperc pontossággal, a NASA JPL efemeridjével és az Astrodienst (Astro.com) hivatalos swetest referenciájával összevetve.

Számok:

• 758 endpoint: nyugati natal asztrológia, szinasztria, tranzitok, progressziók, direkciók, visszatérések, harmonikák, fix csillagok, arab pontok, asztrokartográfia plusz a teljes Human Design készlet
• 183 snapshot-teszt a CI-ban a valós swetest CGI és a NASA elsötétülés katalógus kimenetele 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 public registries-en: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) – ugyanaz az API három nyelven
• MCP-szerver: @astroway/mcp – API-t tool-ként adja Claude, GPT, Cursor és más LLM-ügynököknek
• Credit-alapú tarifák: ingyenes csomag (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/. Élő státusz: api.astroway.info/status.

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

1. Felületes lefedettséggel rendelkeztek (10–30 endpoint, főleg csak natal)
2. Skálázhatóan drágák voltak ($0.02–$0.10 kérésenként, nagykereskedelmi kedvezmények nélkül)
3. Zárt motorokat használtak, amelyek pontosságát nem lehet ellenőrizni
4. A védikus asztrológiára fókuszáltak, a nyugati asztrológiát másodlagosnak tekintették

Ezért saját magunk vendoroltuk a Swiss Ephemeris-t és megírtuk a saját számítási réteget – először a fogyasztói termékhez app.astroway.info, majd a Marketing weboldalhoz astroway.info, amely napi horoszkópokat ad ki több százezer látogatónak havonta.

Két következtetésre jutottunk:

1. Ugyanannak a számítási motorjának elérhetőnek kell lennie más fejlesztők számára: nem azért, mert nem tudnák maguk megírni, hanem azért, mert a könyvtár + WASM + cache + CI a pontosságra stack fél év munkát jelent, amit senki sem érdemes megismételni.
2. A Human Design lefedettségünk (12 endpoint: térkép, típus, autoritás, profil, kapuk, csatornák, kontúrok, planetáris aktivációk, incarnation cross, definition) valóban egyedi. Egyetlen versenytárs sem kínál teljes HD-stack-et API-n keresztül.

Ez a launch.

Van /nakshatras, /ashtakavarga és endpointok a divisional térképekhez, de nincs Dasha, Panchang, Ashtakoota, KP. Ok: a védikus asztrológiában megoldatlan nézeteltérések vannak az iskolák között (ayaṇamś háborúk, KP kulcspontok vitái, dasha iskola választás). A védikus rész Prokerala és VedicAstroAPI ellen készülve csak kritikát kapna.

A döntés rögzítve: a védikus csomag külön 3. fázis, miután stabil kereslet lesz a nyugati irányra, és lesz idő a Jagannatha Hora és Parashara’s Light ellenőrzésére. Jobb, ha egyáltalán nem indítod, mint rosszul indítani.

Egy /chart hívás ~50-szer kevesebb számítást igényel, mint a 365 napos /forecast-calendar. Egy egységes ár per kérés vagy a könnyű felhasználókat vágja le, vagy a nehezeket támogatja. A kreditek a költséget a valós munkához map-elik – lásd a táblázatot az endpointok szerint a tarifák oldalon.

Válaszok az ingyenes csomagon _footer mezőt tartalmaznak:

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

Ez nekünk semmit nem kerül, és az ingyenes felhasználóknak egy kis ösztönzést ad a frissítéshez. A Hobby+ csomagban a kulcs beállításaiban eltávolítjuk. A mintát a Zapier és a RevenueCat-től kölcsönöztük.

/rectification (születési idő kiválasztása élet események alapján likelihood-grid kereséssel) – számításilag drága: egy hívás 10–60 másodpercig tart és tízezrek köztes számítást végez a Swiss Ephemeris-szel. A Pro csomaggal ($59 / hónap) korlátoztuk, és magas kreditárat állítottunk be, mert a visszaélés leterhelné a közös infrastruktúrát mindenki számára.

Az /interpret/* endpointok a saját privát AI-gateway-ünkön keresztül irányítódnak, amely a piac legjobb modelljei (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) felett automatikus failoverrel működik. Nem zárunk be a promptjaidba – minden válasz az értelmezéssel tartalmazza a kiinduló számításokat, így saját LLM-mel felülírhatod, ha a mi hangunk nem tetszik. A teljes promptokat és kimeneteket audit-táblába naplózzuk B2B-kompatibilitásért (90 nap tárolás).

• Védikus csomag: 3. fázis, az első kereslet megerősítése után (lásd fent)
• Webhook-ok a küszöb eléréséhez: megvalósítva, de a UI nyers; továbbfejlesztés alatt
• Publikus widgetek (<script src="api.astroway.info/widget/natal.js">) – 7. fázis
• Plugin a fő Marketing weboldalhoz: külön projekt, a astroway.info ökoszisztéma keretében tervezett

1. Olvasd el a dokumentációt, ha szeretnéd megérteni a „miért” kérdést: api.astroway.info/overview
2. Gyors start 5 perc alatt kóddal: Astrology API Quick Start
3. Tarifák, beleértve a kredittáblázatot endpointonként: api.astroway.info/pricing
4. Regisztrálj: ingyenes, kártya nélkül: api.astroway.info/dashboard/sign-up

Ha építesz valamit az API-val – vagy találsz egy hibát, vagy szeretnél egy olyan endpointot, ami még nincs – írj nekünk. Számunkra jobb száz fejlesztő visszajelzését hallani, mint olyan funkciókat indítani, amiket senki sem használ.

Kérdések, kérések, furcsa edge esetek: hello@astroway.info.

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

Üdvözlünk.