Katalógus térkép: hogyan épülnek fel a 700+ AstroWay endpointja

Az AstroWay katalógus már 758 végpontot tartalmaz 57 csoportban. Ilyen méretnél az integrátor fő kérdése nem az, hogy „elég-e a lefedettség”, hanem az, hogy „hogyan ne vessz el”. Ez a cikk egy térkép: hogyan oszlik meg a katalógus domainekre, és hogyan találhatod meg, amire szükséged van, egy perc alatt.

A domaintől függetlenül minden számítási végpont azonos formával rendelkezik:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

A törzs egy JSON születési adatokkal (dátum, idő, koordináták) vagy technikára specifikus paraméterekkel. A válasz mindig { "ok": true, "data": {...} } vagy { "ok": false, "error": {...} }. Nincs GraphQL, nincs külön auth-flow domainenként: egy kulcs az X-Api-Key fejlécben, egy válaszformátum.

Ez azt jelenti, hogy a natális térképhez írt burkoló BaZi-hoz és rúnákhoz is alkalmas – csak az útvonal és a törzs sémája változik.

A katalógus nagy domainekbe csoportosul. Íme egy térkép valós számlálókkal (a számok minden buildnél a manifesztből származnak, így itt mindig aktuálisak):

A többi – AI-értelmezések, horoszkópok, referencia végpontok (jegyek, bolygók, aspektusok) és rendszer (health, usage, openapi).

A 174 védikus végpont több, mint a teljes nyugati rész. Az ok egyszerű: a védikus hagyomány formálisabb. Ahol a nyugati asztrológia egy házkészlettel rendelkezik, ott a védikus 16 divíziós térképpel (varga), több dasha rendszerrel, több tucat yogával, világos szabályokkal. Mindegyik egy külön végpont determinisztikus eredménnyel.

Ha az indiai piacra építesz, ez a termék magja, nem pedig kiegészítője.

A technika egzotikájától függetlenül a bolygópozíciókat egyetlen Swiss Ephemeris (WASM) mag számítja. Ugyanez a mag működik az alkalmazásunk böngészőjében és az API szerverén is – egyetlen kódbázis, semmi eltérés. A számítási végpontokat 873 snapshot teszt fedi le, amelyek minden PR-nél összehasonlításra kerülnek a referenciaforrásokkal. Erről bővebben egy külön cikkben olvashatsz a CI-pontosságról.

Három út, a leggyorsabbtól kezdve:

1. OpenAPI-referencia - A /docs/api/ közvetlenül a openapi.json éles specifikációból generálódik. Az oldalsávban lévő csoportok = a fenti domainek. Minden végpont rendelkezik törzssémával, példával és egy „próba” gombbal.
2. MCP-katalógus - Ha Claude-ban vagy Cursorban vagy, a teljes katalógus eszközkészletként elérhető az mcp.astroway.info címen keresztül. Az ügynök maga találja meg a szükséges végpontot a leírás alapján.
3. Keresés a specifikációban - A curl https://api.astroway.info/v1/openapi.json visszaadja a teljes géppel olvasható szerződést. Kényelmes a saját kliens kódgenerálásához.

A dashboard/sign-up oldalon található kulcs havi 10 000 kreditet biztosít – ez elegendő ahhoz, hogy több tucat domaint átnézz, és megértsd, mi a tiéd. A katalógust nem kell teljesen áttanulmányozni: vedd a saját domainodat, a többi pedig várni fog, amíg szükséged lesz rá.