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

Dzisiaj ogłaszamy AstroWay API — obliczeniowy backend dla deweloperów, którzy tworzą aplikacje astrologiczne, produkty horoskopowe, funkcje zgodności dla randkowania oraz AI-agenty, które muszą rozważać o kartach urodzenia.

W tym artykule — co tak naprawdę jest wewnątrz API, jakie nietypowe rozwiązania przyjęliśmy, co świadomie zostawiliśmy poza nawiasami i jak do tego doszliśmy. Bez wody.

🕓 Zapis z 2026-04-22, zaktualizowany 2026-05-09. Niektóre cyfry są przestarzałe. Aktualny stan: 723 endpointów (a nie 87 na moment startu), 818 CI snapshot-testów (a nie 183), serwer MCP @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk teraz wszystkie żyją na publicznych rejestrach. Świeży status — w /faq i changelog.

REST API oparte na Swiss Ephemeris (LGPL), skompilowane w WASM i wdrożone jako usługa Node.js — teraz również z interpretacjami AI (łańcuch failover GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) nad rzeczywistymi obliczeniami. Ten sam silnik, którym profesjonalni astrologowie 30+ lat korzystają w Solar Fire, Kepler, Astro Gold i Janus — dokładność do części kątowej sekundy, zweryfikowana z ephemeris NASA JPL i oficjalnym swetest reference od Astrodienst (Astro.com).

Cyfry:

• 723 endpoint — zachodnia astrologia urodzeniowa, synastria, transity, progresje, dyrektywy, powroty, harmoniki, fiksyjne gwiazdy, punkty arabskie, astrokartografia plus pełny zestaw Human Design
• 183 snapshot-testy w CI przeciwko rzeczywistemu wyjściu swetest CGI i katalogowi zaćmień NASA — gonione na każdym PR
• p50 < 100 ms, p95 < 500 ms dla typowych obliczeniowych endpointów
• Serwer MCP @astroway/mcp + trzy SDK na publicznych rejestrach: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — ten sam API w trzech językach
• Serwer MCP: @astroway/mcp — wydaje API jako tool-y dla Claude, GPT, Cursor i innych LLM-agentów
• Credit-based taryfy: bezpłatny plan (10 000 kredytów / miesiąc, bez karty), płatne — od $5 / miesiąc

Pełna dokumentacja: api.astroway.info/docs/api/. Żywy status: api.astroway.info/status.

Trzy lata temu zaczęliśmy budować aplikacje astrologiczne dla konsumentów. Warstwa obliczeniowa okazała się najtrudniejszą częścią — znacznie trudniejszą niż UI czy zawartość. Istniejące usługi albo:

1. Miały powierzchowne pokrycie (10–30 endpointów, głównie tylko urodzeniowe)
2. Były drogie w skali ($0.02–$0.10 za żądanie bez rabatów hurtowych)
3. Używały zamkniętych silników, których dokładność nie mogła być sprawdzona
4. Skierowane były na astrologię wedycką, a zachodnią traktowały jako drugorzędną

Więc sami zaimplementowaliśmy Swiss Ephemeris i napisaliśmy własną warstwę obliczeniową — najpierw dla aplikacji konsumenta app.astroway.info, potem dla strony marketingowej astroway.info, która wydaje codzienne horoskopy setkom tysięcy odwiedzających na miesiąc.

Przez trzy lata pracy tego kodu w produkcji doszliśmy do dwóch wniosków:

1. Ten sam silnik obliczeniowy powinien być dostępny innym deweloperom — nie dlatego, że nie będą w stanie go napisać sami, ale dlatego, że stos biblioteka + WASM + buforowanie + CI na dokładność — 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, kontury, aktywacje planetarne, incarnation cross, definicja) — jest naprawdę unikalne. Żaden konkurent nie oferuje pełnego zestawu HD przez API.

To jest start.

Mamy /nakshatras, /ashtakavarga oraz endpointy dla divisional-kart, ale brakuje Dasha, Panchang, Ashtakoota, KP. Powód: w astrologii wedyckiej są nierozwiązane różnice między szkołami (wojny ayanamsh, spory o kuśpidy KP, wybór szkoły dash). Szybko zrobiona część wedycka przeciwko Prokerala i VedicAstroAPI po prostu dostałaby krytykę.

Rozwiązanie jest ustalone: pakiet wedycki — oddzielna faza 3, po pierwszych potwierdzeniach popytu (patrz wyżej).

Jedno wywołanie /chart kosztuje około 50 razy mniej obliczeń niż 365-dniowy /forecast-calendar. Płaska cena za żądanie albo odcięłaby lekkich użytkowników, albo subsydiowałaby ciężkich. Kredyty mapują koszt do rzeczywistej pracy — patrz tabela po endpointach na stronie taryf.

Odpowiedzi na bezpłatnym planie zawierają pole _footer:

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

Nam to nic nie kosztuje, a bezpłatnym użytkownikom daje niewielki powód do aktualizacji. Na planie Hobby+ można to usunąć w ustawieniach klucza. Wzorzec pożyczyliśmy od Zapier i RevenueCat.

/rectification (dobór czasu urodzenia według zdarzeń życia przez likelihood-grid wyszukiwanie) — obliczeniowo drogi: jedno wywołanie trwa 10–60 sekund i robi dziesiątki tysięcy pośrednich obliczeń Swiss Ephemeris. Ograniczyliśmy je do planu Pro ($59 / miesiąc) i ustaliliśmy wysoką cenę kredytową, bo nadużycie położyłoby wspólną infrastrukturę dla wszystkich innych.

Endpointy /interpret/* są routowane przez naszą prywatną AI-bramę, która nad best-of-breed modelami rynku (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) z automatycznym failover. Nie zamykamy cię w naszych promtach — każda odpowiedź z interpretacją zawiera źródłowe obliczenia, więc możesz przeprosić własną LLM, jeśli nasz głos ci nie pasuje. Pełne prompty i wyjścia logujemy w tabeli audytu dla B2B-kompatybilności (przechowywanie 90 dni).

• Pakiet wedycki — faza 3, po pierwszych potwierdzeniach popytu (patrz wyżej)
• Webhook-i na osiągnięcie progów — zaimplementowane, ale UI jest surowe; dopracowujemy
• Publiczne widżety (<script src="api.astroway.info/widget/natal.js">) — faza 7
• Wtyczka do głównej strony marketingowej — oddzielny projekt, planowany w ramach ekosystemu astroway.info

1. Przeczytaj dokumentację jeśli chcesz zrozumieć «dlaczego»: api.astroway.info/overview
2. Szybki start za 5 minut z kodem: Astrology API Quick Start
3. Taryfy, 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 znajdziesz błąd, albo będziesz chciał endpointu, którego u nas jeszcze nie ma — napisz nam. Nam lepiej słyszeć sto deweloperów, którzy czegoś proszą, niż wdrażać funkcje, których nikt nie używa.

Pytania, prośby, dziwne edge-kaze: hello@astroway.info.

Roadmap jest publiczny — PRODUCT-PLAN.md — co zostało zrobione, co następne, co odroczono i dlaczego.

Witaj.