FAQ answers

Obecné

Co je AstroWay API?

Profesionální HTTP API pro astrologické výpočty. 714 endpoint na základě Swiss Ephemeris (WASM): natální mapy, synastrie, progrese, direkce, tranzity, Human Design, astrokartografie, rektifikace, AI interpretace. Všechny výpočty jsou na serveru – žádné závislosti na straně klienta.

Pro koho je tento API?

Pro vývojáře, kteří vytvářejí astrologické aplikace (web/mobilní), AI společnosti, které přidávají astrologické funkce, profesionální astrologové se skripty a výzkumníci, kteří potřebují programový přístup k výpočtům.

Jaká je přesnost výpočtů?

Swiss Ephemeris zajišťuje přesnost planetárních pozic do ±1 úhlové sekundy, kupelet domů – do ±1 úhlové minuty. Výsledky jsou verifikovány proti Astrodienst (Astro.com), Solar Fire, Zet 9 a Kepler. Sub-arcsecond drift vs NASA JPL ephemeris a NASA 5-Millennium Eclipse Catalog.

Jak se AstroWay srovnává s Astro.com nebo Solar Fire?

Identický engine Swiss Ephemeris – stejný jako v Solar Fire ($495 licence), Kepler ($995), Astro Gold ($29.99/měs) a Astrodienst (Astro.com). Validováno proti NASA JPL ephemeris a oficiálnímu swetest reference od Astrodienst. Sub-arcsecond drift (≤0.1″) na planetárních pozicích, ≤1 minuta na zatměních. Rozdíl: AstroWay – REST API od $5/měs místo one-time licence nebo desktop GUI.

Jaké systémy domů jsou podporovány?

15 systémů: Placidus (výchozí), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC a Equal od MC. Předdej příslušný kód v parametru houseSystem.

Kredity a platba

Jak funguje kreditní systém?

Každý endpoint má pevnou cenu v kreditách (od 10 do 500), v závislosti na složitosti výpočtu. Jednoduchý lookup – 10, natální mapa – 20, synastrie – 50, rektifikace – 500. Úplná tabulka – na stránce Ceník.

Je bezplatný tarif?

Ano. Free plán poskytuje 10 000 kreditů/měsíc, 10 req/min. Bez zadání karty. Dostačující pro vyhodnocení produktu a prototypování.

Co se stane, když kredity skončí?

Na Free – požadavky jsou blokovány do následujícího měsíce (429 CREDITS_EXHAUSTED). Na Indie/Starter/Pro/Business – je zapnuta přeplatková sazba: $5 / $3 / $2 za 10 000 dalších kreditů.

Jsou cacheovány stejné požadavky?

Ano. Identický input během 5 minut je vrácen z cache bez odečtení kreditů. Potvrzeno hlavičkou X-Cache: HIT.

Je možné koupit kredity bez předplatného?

Zatím ne. Předplatné poskytuje předvídatelný rozpočet a lepší limit sazby. Pay-as-you-go plán je plánován.

Technické

Jaké SDK jsou k dispozici?

• MCP server zrealizováno: npx -y @astroway/mcp – expozuje všechny 714+ endpointy jako nástroje pro Claude $1, Cursor, GPT a další MCP-kompatibilní AI-agenty
• TypeScript SDK zrealizováno: npm install @astroway/sdk – typy + autocomplete z OpenAPI 3.1, retry + idempotency, Stainless-style chyby
• Python SDK zrealizováno: pip install astroway – sync Astroway + async AsyncAstroway, na základě httpx, PEP 561 typed
• PHP SDK zrealizováno: composer require astroway/sdk – PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust naplánováno – přihlaste se k oznámení prostřednictvím e-mailu na stránce každého SDK (/sdk/<language>/)

Kontakt API – standardní REST + JSON, takže jakýkoli HTTP klient funguje bez SDK. Postman collection a OpenAPI 3.1 spec jsou veřejně dostupné.

Je sandbox režim?

Ano. Klíče aw_test_* neodečtou kredity a vrátí stejné výsledky. Ideální pro vývoj a testování.

Jaký je limit sazby?

Závisí na plánu: Free – 10, Indie – 30, Starter – 120, Pro – 400, Business – 1 000 req/min. Při překročení – 429 s hlavičkou Retry-After.

Je podporován sidereální zvěrokruh?

Ano. Předdej "zodiacType": "sidereal" a volitelně "ayanamsaId" (výchozí – Lahiri). Funguje se všemi endpointy.

Co jsou Human Design endpointy?

12 endpointů pro výpočet Human Design: typ, strategie, autorita, profil, určení, inkarnační kříž, kanály, centra, Dream Rave, Hologenetic Profile, Penta (skupinová dynamika), časová citlivost. Nejhlubší pokrytí HD mezi komerčními API.

Bezpečnost a soukromí

Jsou uloženy data o požadavcích?

API funguje stateless – data o datu/času/místu narození nejsou uložena po zpracování požadavku. Logovány jsou pouze metadata: key_id, endpoint, timestamp, latency, kredity. Žádná osobní data.

Odpovídá API požadavkům GDPR?

Ano. Data nejsou uložena. Pro uživatele z EU: žádná zpracování PII, žádná profilace, žádné cookies. API klíč je vázaný na účet, ne na konečného uživatele.

Jsou AI interpretace bezpečné?

AI-endpointy (/interpret/*, /horoscope/*) mají vestavěné bezpečnostní zábrany: zákaz lékařských, právních, finančních rad. Každá odpověď obsahuje disclaimer. Úplná auditní stopa – pro podnikovou compliance.

Podpora

Jak získat pomoc?

Závisí na plánu: Free – komunita, Indie – e-mail (48 hodin), Starter – e-mail (24 hodin), Pro – e-mail (4 hodiny), Business – e-mail + Slack (1 hodina), Enterprise – vyhrazený manažer ve Slacku. Kontakty – na stránce Kontakty.

Je SLA?

Indie: 99% uptime. Starter a Pro: 99,9% uptime. Business: 99,95% uptime. Enterprise: custom SLA s finančními garancemi.