Katalog AstroWay to już 865 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 | 186 | Mapa natalna, aspekty, godności, prognostyka (tranzyty, progresje, dyrekcje), horary, 4 szkoły hellenistyczne, współczesna psychologiczna, ewolucyjna, kosmo-biologia |
| Wedyjska | 230 | 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 | 71 | Trzy talie: Rider-Waite-Smith, Marseille, Lenormand – rozkłady, znaczenia, kombinacje |
| Numerologia | 55 | 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 | 40 | Geomancja (Agrippa), runy Starszego Futharku, chiromancja (Cheiro), I Ching |
| Nisze aplikacyjne | 53 | Wellness, astrologia zwierząt, biznes, finanse, rodzinna |
| Raporty | 29 | 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 | 47 | 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”230 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. To samo jądro działa zarówno w naszej aplikacji, jak i w API – jedna baza kodu, żadnych rozbieżności. Endpointy obliczeniowe są pokryte 888 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.
Pozycje do sekundy łuku w 4 liniach kodu.
Darmowy klucz bez karty. 5 000 wywołań miesięcznie do pierwszej płatności.