Mapa katalogu: jak jsou uspořádány 700+ endpointů AstroWay

Katalog AstroWay už obsahuje 865 endpointů ve 57 skupinách. V takovém měřítku je hlavní otázkou integrátora ne “zda stačí pokrytí”, ale “jak se neztratit”. Tento článek je mapa: jak je katalog rozdělen do domén a jak najít to potřebné během minuty.

Bez ohledu na doménu má každý výpočetní endpoint stejný tvar:

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

Tělo – JSON s údaji o narození (datum, čas, souřadnice) nebo specifickými parametry pro techniku. Odpověď – vždy { "ok": true, "data": {...} } nebo { "ok": false, "error": {...} }. Žádné GraphQL, žádné samostatné auth-flow na doménu: jeden klíč v hlavičce X-Api-Key, jeden formát odpovědi.

To znamená, že obal, který píšeš pro natalní kartu, funguje i pro BaZi i pro runy – mění se jen cesta a schéma těla.

Katalog je rozdělen do velkých domén. Zde je mapa s reálnými počítadly (čísla jsou brána z manifestu na každém buildu, takže jsou zde vždy aktuální):

Zbytek – AI-interpretace, horoskopy, referenční endpointy (znaky, planety, aspekty) a systémové (health, usage, openapi).

230 védických endpointů – to je více než celá západní část. Důvod je jednoduchý: védická tradice je formalizovanější. Tam, kde západní astrologie má jeden soubor domů, védická má 16 divisional-karet (varga), několik systémů dasha, desítky yog s jasnými pravidly. Každé z toho je samostatný endpoint s determinovaným výsledkem.

Pokud buduješ pro indický trh, je to jádro produktu, ne doplněk.

Bez ohledu na exotiku techniky se planetární pozice počítají jedním jádrem na Swiss Ephemeris. To samé jádro funguje jak v naší aplikaci, tak v API – jedna kódová báze, žádné rozdíly. Výpočetní endpointy jsou pokryty 888 snapshot-testy, které se na každém PR porovnávají s referenčními zdroji. Více o tom v samostatném článku o CI-přesnosti.

Tři cesty, od nejrychlejší:

1. OpenAPI-průvodce – /docs/api/ generuje se přímo z produkční specifikace openapi.json. Skupiny v postranním panelu = domény výše. Každý endpoint má schéma těla, příklad a tlačítko “vyzkoušet”.
2. MCP-katalog – pokud jsi v Claude nebo Cursor, celý katalog je dostupný jako sada nástrojů přes mcp.astroway.info. Agent sám najde požadovaný endpoint podle popisu.
3. Vyhledávání podle specifikace – curl https://api.astroway.info/v1/openapi.json vrací kompletní strojově čitelný kontrakt. Pohodlné pro generování kódu vlastního klienta.

Klíč na dashboard/přihlášení dává 10 000 kreditů za měsíc – stačí na projití desítek domén a pochopení, co z toho je tvé. Katalog není potřeba učit zpaměti: vezmi si svou doménu a zbytek bude čekat, až budeš potřebovat.