Katalog AstroWay to już 758 endpointów w 57 grupach. W takiej skali główne pytanie integratora nie brzmi „czy pokrycie będzie wystarczające”, lecz „jak się nie zgubić”. Ten artykuł to mapa: jak katalog jest podzielony na domeny i jak znaleźć to, czego potrzebujesz, w minutę.
Jeden wzorzec dla wszystkich wywołań
Dział zatytułowany „Jeden wzorzec dla wszystkich wywołań”Niezależnie od domeny, każdy endpoint obliczeniowy ma identyczną formę:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonCiało (body) to JSON z danymi urodzenia (data, czas, współrzędne) lub parametrami specyficznymi dla techniki. Odpowiedź to zawsze { "ok": true, "data": {...} } lub { "ok": false, "error": {...} }. Żadnego GraphQL, żadnych oddzielnych auth-flow na domenę: jeden klucz w nagłówku X-Api-Key, jeden format odpowiedzi.
Oznacza to, że wrapper, który piszesz dla mapy natalnej, pasuje również do BaZi i run – zmienia się tylko ścieżka i schemat ciała (body).
Domeny katalogu
Dział zatytułowany „Domeny katalogu”Katalog grupuje się w duże domeny. Oto mapa z rzeczywistymi licznikami (liczby pochodzą z manifestu przy każdym buildzie, więc są tutaj zawsze aktualne):
| Domena | Endpointów | Co w środku |
|---|---|---|
| Astrologia zachodnia | 182 | Mapa natalna, aspekty, godności, prognostyka (tranzyty, progresje, dyrekcje), horary, 4 szkoły hellenistyczne, współczesna psychologiczna, ewolucyjna, kosmo-biologia |
| Wedyjska | 174 | Największa domena: nakshatras, dashas, mapy dywizyjne (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Bodygraph, kanały, bramy, typ/profil/autorytet, krzyż inkarnacyjny |
| Tarot | 66 | Trzy talie: Rider-Waite-Smith, Marseille, Lenormand – rozkłady, znaczenia, kombinacje |
| Numerologia | 50 | 5 systemów po 10 obliczeń (pitagorejska, chaldejska, dwie kabalistyczne, wedyjska) |
| Chińska + Majów | 55 | BaZi (cztery filary), Zi Wei Dou Shu, chiński zodiak i feng shui, kalendarze Majów |
| Wróżenie | 31 | Geomancja (Agrippa), runy Starszego Futharku, chiromancja (Cheiro), I Ching |
| Nisze aplikacyjne | 51 | Wellness, astrologia zwierząt, biznes, finanse, rodzinna |
| Raporty | 23 | Gotowe interpretacje (natal, synastry), w HTML/PDF, z brandingiem white-label |
| Renderowanie | 14 | SVG/PNG koła map, bodygraph, pierścienie tranzytowe – bez własnego frontendu |
| Narzędzia deweloperskie | 44 | Webhooki, streaming w czasie rzeczywistym, osadzane widżety, white-label |
Reszta to interpretacje AI, horoskopy, referencyjne endpointy (znaki, planety, aspekty) i systemowe (health, usage, openapi).
Wedyjska – osobna historia
Dział zatytułowany „Wedyjska – osobna historia”174 wedyjskich endpointów to więcej niż cała część zachodnia. Powód jest prosty: tradycja wedyjska jest bardziej sformalizowana. Tam, gdzie astrologia zachodnia ma jeden zestaw domów, wedyjska ma 16 map dywizyjnych (varga), kilka systemów dasha, dziesiątki yogas z jasnymi zasadami. Każde z nich to osobny endpoint z zdeterminowanym wynikiem.
Jeśli budujesz pod rynek indyjski, to jest to rdzeń produktu, a nie dodatek.
Dokładność pod tym wszystkim
Dział zatytułowany „Dokładność pod tym wszystkim”Niezależnie od egzotyki techniki, pozycje planetarne są obliczane przez jedno jądro na Swiss Ephemeris (WASM). To samo jądro działa zarówno w przeglądarce naszej aplikacji, jak i na serwerze API – jedna baza kodu, żadnych rozbieżności. Endpointy obliczeniowe są pokryte 873 testami snapshot, które przy każdym PR są weryfikowane z referencyjnymi źródłami. Więcej na ten temat – w osobnym artykule o dokładności CI.
Jak znaleźć to, czego potrzebujesz
Dział zatytułowany „Jak znaleźć to, czego potrzebujesz”Trzy ścieżki, od najszybszej:
- Dokumentacja OpenAPI - /docs/api/ jest generowana bezpośrednio ze specyfikacji produkcyjnej
openapi.json. Grupy w pasku bocznym = domeny powyżej. Każdy endpoint ma schemat ciała (body), przykład i przycisk „wypróbuj”. - Katalog MCP - jeśli używasz Claude’a lub Cursora, cały katalog jest dostępny jako zestaw narzędzi poprzez
mcp.astroway.info. Agent sam znajduje potrzebny endpoint na podstawie opisu. - Wyszukiwanie w specyfikacji -
curl https://api.astroway.info/v1/openapi.jsonzwraca pełny, czytelny maszynowo kontrakt. Wygodne do generowania własnego klienta.
Zacznij
Dział zatytułowany „Zacznij”Klucz na dashboard/sign-up daje 10 000 kredytów miesięcznie – wystarczająco, aby przejść przez dziesiątki domen i zrozumieć, co z tego jest dla Ciebie. Nie musisz studiować całego katalogu: weź swoją domenę, a reszta poczeka, aż będzie potrzebna.
Ten sam Swiss Ephemeris, co w Solar Fire - w 4 liniach kodu.
Darmowy klucz bez karty. 5 000 wywołań miesięcznie do pierwszej płatności.