Uruchomienie AstroWay API: pełny stos obliczeń astrologicznych z dokładnością Swiss Ephemeris

Dziś ogłaszamy AstroWay API – obliczeniowy backend dla deweloperów, którzy tworzą aplikacje astrologiczne, produkty horoskopowe, funkcje kompatybilności dla randkowania i agentów AI, którzy mają rozumować na temat map urodzeniowych.

W tym artykule – co tak naprawdę kryje się w API, jakie nietypowe decyzje podjęliśmy, co świadomie pominęliśmy i jak do tego doszliśmy. Bez lania wody.

🕓 Zapis z 2026-04-22, zaktualizowano 2026-05-09. Niektóre liczby są nieaktualne. Aktualny stan: 865 endpointów (a nie 87 w momencie launchu), 888 testów snapshot CI (a nie 183), serwer MCP @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk są teraz dostępne w publicznych rejestrach. Świeży status – w /faq i changelog.

REST API oparte na Swiss Ephemeris – teraz także z interpretacjami AI na podstawie rzeczywistych obliczeń. Ten sam silnik, którego profesjonalni astrolodzy używają od ponad 30 lat w Solar Fire, Kepler, Astro Gold i Janus – dokładność do ułamka sekundy kątowej, zweryfikowana z efemerydą NASA JPL i oficjalnym swetest reference od Astrodienst (Astro.com).

Liczby:

• 865 endpointów: zachodnia astrologia natalna, synastria, tranzyty, progresje, dyrekcje, powroty, harmoniki, gwiazdy stałe, punkty arabskie, astrogeografia plus pełny zestaw Human Design
• 183 testy snapshot w CI przeciwko rzeczywistemu wyjściu swetest CGI i katalogowi zaćmień NASA – uruchamiane przy każdym PR
• p50 < 100 ms, p95 < 500 ms dla typowych obliczeniowych endpointów
• Serwer MCP @astroway/mcp + trzy SDK w publicznych rejestrach: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) – to samo API w trzech językach
• Serwer MCP: @astroway/mcp – udostępnia API jako narzędzia dla Claude, GPT, Cursor i innych agentów LLM
• Plany oparte na kredytach: darmowy plan (10 000 kredytów / miesiąc, bez karty), płatne – od 5 $ / miesiąc

Pełna dokumentacja: api.astroway.info/docs/api/. Status na żywo: api.astroway.info/status.

Trzy lata temu zaczęliśmy budować konsumenckie aplikacje astrologiczne. Warstwa obliczeniowa okazała się najtrudniejszą częścią – znacznie trudniejszą niż UI czy content. Istniejące usługi albo:

1. Miały powierzchowne pokrycie (10–30 endpointów, głównie tylko natal)
2. Były drogie w skali (0.02–0.10 $ za zapytanie bez zniżek hurtowych)
3. Używały zamkniętych silników, których dokładności nie da się zweryfikować
4. Skupiały się na astrologii wedyjskiej, a zachodnią traktowały jako drugorzędną

Więc samodzielnie zintegrowaliśmy Swiss Ephemeris i napisaliśmy własną warstwę obliczeniową – najpierw dla produktu konsumenckiego app.astroway.info, potem dla strony marketingowej astroway.info, która dostarcza codzienne horoskopy setkom tysięcy odwiedzających miesięcznie.

Po trzech latach działania tego kodu w produkcji doszliśmy do dwóch wniosków:

1. Ten sam silnik obliczeniowy powinien być dostępny dla innych deweloperów: nie dlatego, że nie będą w stanie napisać go samodzielnie, ale dlatego, że stos biblioteka + buforowanie + CI pod kątem dokładności – to pół roku pracy, której nikt nie powinien powtarzać.
2. Nasze pokrycie Human Design (12 endpointów: mapa, typ, autorytet, profil, bramy, kanały, obwody, aktywacje planetarne, incarnation cross, definition) – jest naprawdę unikalne. Żaden konkurent nie oferuje pełnego stosu HD przez API.

To jest właśnie launch.

Mamy /nakshatras, /ashtakavarga i endpointy dla map dywizyjnych, ale nie ma Dasha, Panchang, Ashtakoota, KP. Powód: w astrologii wedyjskiej istnieją nierozwiązane rozbieżności między szkołami (wojny ajanamś, spory o kuspisy KP, wybór szkoły dasz). Naprędce zrobiona część wedyjska w porównaniu z Prokerala i VedicAstroAPI po prostu spotkałaby się z krytyką.

Decyzja jest ustalona: pakiet wedyjski – osobna faza 3, po tym, jak będzie stabilne zapotrzebowanie na astrologię zachodnią i będzie czas na walidację w porównaniu z Jagannatha Hora i Parashara’s Light. Lepiej nie uruchamiać wcale, niż uruchomić źle.

Jedno wywołanie /chart kosztuje około 50 razy mniej obliczeń niż 365-dniowy /forecast-calendar. Płaska cena za zapytanie albo odcinałaby lekkich użytkowników, albo subsydiowałaby ciężkich. Kredyty mapują koszt do rzeczywistej pracy – zobacz tabelę dla endpointów na stronie cennika.

Odpowiedzi w darmowym planie zawierają pole _footer:

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

Nas to nic nie kosztuje, a darmowym użytkownikom daje niewielki powód do uaktualnienia. W planie Hobby+ jest usuwany w ustawieniach klucza. Wzorzec zapożyczyliśmy od Zapier i RevenueCat.

/rectification (dobór czasu urodzenia na podstawie wydarzeń życiowych poprzez wyszukiwanie likelihood-grid) – jest kosztowny obliczeniowo: jedno wywołanie trwa 10–60 sekund i wykonuje dziesiątki tysięcy pośrednich obliczeń Swiss Ephemeris. Ograniczyliśmy go do planu Pro (59 $ / miesiąc) i ustaliliśmy wysoką cenę kredytową, ponieważ nadużycie obciążyłoby wspólną infrastrukturę dla wszystkich innych.

Endpointy /interpret/* działają przez naszą prywatną bramę AI z automatycznym przełączaniem awaryjnym między kilkoma modelami. Nie zamykamy Cię w naszych promptach – każda odpowiedź z interpretacją zawiera wyjściowe obliczenia, więc możesz użyć własnego LLM, jeśli nasz ton Ci nie odpowiada. Pełne prompty i wyjścia logujemy do tabeli audytowej dla zgodności B2B (przechowywanie 90 dni).

• Pakiet wedyjski: faza 3, po pierwszych potwierdzeniach popytu (patrz wyżej)
• Webhooki po osiągnięciu progów: zaimplementowane, ale UI jest surowy; dopracowujemy
• Publiczne widżety (<script src="api.astroway.info/widget/natal.js">) – faza 7
• Wtyczka dla głównej strony marketingowej: osobny projekt, planowany w ramach ekosystemu astroway.info

1. Przeczytaj dokumentację, jeśli chcesz zrozumieć “dlaczego”: api.astroway.info/overview
2. Szybki start w 5 minut z kodem: Astrology API Quick Start
3. Cennik, w tym tabela kredytów na endpoint: api.astroway.info/pricing
4. Zarejestruj się: bezpłatnie, bez karty: api.astroway.info/dashboard/sign-up

Jeśli zbudujesz coś na API – albo złapiesz błąd, albo będziesz chciał endpointu, którego jeszcze nie mamy – napisz do nas. Wolimy usłyszeć stu deweloperów, którzy o coś proszą, niż uruchamiać funkcje, z których nikt nie korzysta.

Pytania, zapytania, dziwne edge-case’y: hello@astroway.info.

Roadmap jest publiczny – PRODUCT-PLAN.md – co zostało zrobione, co jest następne, co zostało odłożone i dlaczego.

Zapraszamy.