Spuštění AstroWay API: kompletní stack astrologických výpočtů s přesností Swiss Ephemeris

V tomto článku se dozvíš, co se skutečně skrývá uvnitř API, jaká neobvyklá řešení jsme přijali, co jsme vědomě vynechali a jak jsme se k tomu dostali. Bez zbytečných řečí.

🕓 Zápis z 22. dubna 2026, aktualizováno 9. května 2026. Některá čísla jsou zastaralá. Aktuální stav: 723 endpointů (místo původních 87 v době spuštění), 818 CI snapshot testů (místo 183), MCP server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk jsou nyní dostupné v veřejných registrech. Aktuální stav najdeš na /faq a changelog.

REST API postavené na Swiss Ephemeris (LGPL), zkompilované do WASM a nasazené jako Node.js služba — nyní s AI interpretacemi (failover řetězec GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) nad skutečnými výpočty. Stejný engine, který profesionální astrologové používají již 30+ let v nástrojích jako Solar Fire, Kepler, Astro Gold a Janus — přesnost až na úroveň úhlových sekund, srovnaná s efemeridou NASA JPL a oficiálním referenčním swetest od Astrodienst (Astro.com).

Čísla:

• 723 endpointů — západní natalní astrologie, synastrie, transity, progrese, direkce, návraty, harmonie, fixní hvězdy, arabské body, astrokartografie plus plný balík Human Design
• 183 snapshot testů v CI proti skutečnému výstupu z swetest CGI a katalogu zatmění NASA — spouští se při každém PR
• p50 < 100 ms, p95 < 500 ms pro typické výpočetní endpointy
• MCP server @astroway/mcp + tři SDK v veřejných registrech: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — stejný API ve třech jazycích
• MCP server: @astroway/mcp — vystavuje API jako nástroje pro agenty LLM jako Claude, GPT, Cursor a další
• Credit-based tarify: bezplatný plán (10 000 kreditů / měsíc, bez karty), placené od $5 / měsíc

Úplná dokumentace: api.astroway.info/docs/api/. Aktuální stav: api.astroway.info/status.

Před třemi lety jsme začali stavět spotřebitelské astrologické aplikace. Výpočetní vrstva se ukázala jako nejsložitější část — mnohem složitější než UI nebo obsah. Stávající služby buď:

1. Měly povrchní pokrytí (10–30 endpointů, převážně pouze natalní)
2. Byly drahé ve velkém měřítku ($0.02–$0.10 za požadavek bez hromadných slev)
3. Používaly uzavřené enginy, jejichž přesnost nelze ověřit
4. Zaměřovaly se na védskou astrologii, zatímco západní astrologii považovaly za druhořadou

Proto jsme si Swiss Ephemeris nainstalovali sami a napsali vlastní výpočetní vrstvu — nejprve pro spotřebitelský produkt app.astroway.info, poté pro marketingový web astroway.info, který denně generuje horoskopy pro stovky tisíc návštěvníků měsíčně.

Po třech letech provozu tohoto kódu v produkci jsme dospěli ke dvěma závěrům:

1. Stejný výpočetní engine by měl být dostupný i dalším vývojářům — ne proto, že by si ho nedokázali napsat sami, ale protože stack knihovna + WASM + cachování + CI pro kontrolu přesnosti představuje půl roku práce, kterou se nikomu nechce opakovat.
2. Naše pokrytí Human Design (12 endpointů — mapa, typ, autorita, profil, brány, kanály, obvody, planetární aktivace, inkarnace kříž, definice) je skutečně unikátní. Žádný konkurent nenabízí plný HD stack přes API.

A to je právě spuštění.

Máme /nakshatras, /ashtakavarga a endpointy pro divisionální mapy, ale žádné Dasha, Panchang, Ashtakoota, KP. Důvod: ve védské astrologii existují nevyřešené rozpory mezi školami (války o ayanamsha, spory o KP cuspy, výběr školy dasha). Pospíchaná implementace proti Prokerala a VedicAstroAPI by si vysloužila kritiku.

Rozhodnutí je pevné: védický balík je ve fázi 3, až bude stabilní poptávka po západní astrologii a bude čas na validaci proti Jagannatha Hora a Parashara’s Light. Raději vůbec nezačneme, než abychom spustili něco nekvalitního.

Jeden požadavek na /chart stojí zhruba 50× méně výpočtů než 365denní /forecast-calendar. Plochá cena za požadavek by buď odřízla lehké uživatele, nebo by dotovala ty těžké. Kredity mapují náklady na skutečnou práci — viz tabulku endpointů na stránce s tarify.

Odpovědi na bezplatném plánu obsahují pole _footer:

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

Námi to nic nestojí, ale bezplatným uživatelům to dává malý podnět k upgrade. Na tarifu Hobby+ je to odstraněno v nastavení klíče. Vzor jsme převzali od Zapieru a RevenueCatu.

/rectification (hledání času narození podle životních událostí pomocí gridu pravděpodobností) je výpočetně náročné: jeden požadavek trvá 10–60 sekund a provádí desítky tisíc mezivýpočtů Swiss Ephemeris. Omezili jsme ho na tarif Pro ($59 / měsíc) a nastavili vysokou cenu za kredity, protože zneužití by ohrozilo společnou infrastrukturu pro všechny ostatní.

Endpointy /interpret/* jsou směrovány přes náš privátní AI-gateway, který využívá best-of-breed modely trhu (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) s automatickým failover. Neuzavíráme tě do svých promptů — každá odpověď s interpretací obsahuje původní výpočty, takže si můžeš nahradit vlastní LLM, pokud se ti náš hlas nelíbí. Úplné prompty a výstupy logujeme do auditní tabulky pro B2B compliance (uložení 90 dní).

• Védický balík — fáze 3, až bude stabilní poptávka (viz výše)
• Webhooky pro dosažení prahů — implementováno, ale UI je syrové; doladíme
• Veřejné widgety (<script src="api.astroway.info/widget/natal.js">) — fáze 7
• Plugin pro hlavní marketingový web — samostatný projekt, plánováno v rámci ekosystému astroway.info

1. Přečti si dokumentaci, pokud chceš pochopit „proč“: api.astroway.info/overview
2. Rychlý start za 5 minut s kódem: Astrology API Quick Start
3. Tarify, včetně tabulky kreditů na endpoint: api.astroway.info/pricing
4. Zaregistruj se — zdarma, bez karty: api.astroway.info/dashboard/sign-up

Pokud na API postavíš něco — ať už objevíš chybu, nebo budeš chtít endpoint, který u nás ještě není — dej nám vědět. Raději uslyšíme sto vývojářů, kteří něco požadují, než abychom spouštěli funkce, které nikdo nepoužívá.

Dotazy, požadavky, podivné edge-kazy: hello@astroway.info.

Roadmapa je veřejná — PRODUCT-PLAN.md — co je hotovo, co je příští a co je odloženo a proč.

Vítej.