FAQ answers

Obecné

Co je AstroWay API?

Profesionální HTTP API pro astrologické výpočty. 771 endpoint na bázi Swiss Ephemeris: natalové mapy, synastrie, progresie, direkce, tranzity, Human Design, astrokartografie, rektifikace, AI-interpretace. Všechny výpočty na serveru – žádné závislosti na straně klienta.

Pro koho je toto API?

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

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

Swiss Ephemeris poskytuje přesnost planetárních pozic do ±1 úhlové sekundy, cúspidů domů – do ±1 úhlové minuty. Výsledky jsou ověřeny 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 – ten samý, který je 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 jednorázové 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ředávej odpovídající kód v parametru houseSystem.

Kredity a platby

Jak funguje kreditní systém?

Každý endpoint má pevnou cenu v kreditech (od 10 do 500), podle složitosti výpočtu. Jednoduchý lookup – 10, natalová karta – 20, synastrie – 50, rektifikace – 500. Kompletní tabulka – na stránce Tarify.

Je k dispozici bezplatný tarif?

Ano. Free plán poskytuje 10 000 kreditů/měsíc, 10 req/min. Bez zadání karty. Dostatečný pro vyzkoušení produktu a prototypování.

Co se stane, když kredity dojdou?

U Free – požadavky jsou blokovány do dalšího měsíce (429 CREDITS_EXHAUSTED). U Indie/Starter/Pro/Business se aktivuje overage: $5 / $3 / $2 za 10 000 dalších kreditů.

Cacheují se stejné požadavky?

Ano. Identický input během 5 minut se vrací z cache bez odečtení kreditů. Potvrzuje se hlavičkou X-Cache: HIT.

Lze koupit kredity bez předplatného?

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

Technické

Jaké SDK jsou k dispozici?

• MCP server ✅ zrealizováno: npx -y @astroway/mcp: exponuje všechny 771+ endpointy jako nástroje pro Claude Desktop, Cursor, GPT a další MCP-kompatibilní AI agenty
• TypeScript SDK ✅ zrealizováno: npm install @astroway/sdk: typy + autocomplete z OpenAPI 3.1, retry + idempotency, chyby ve stylu Stainless
• Python SDK ✅ zrealizováno: pip install astroway: sync Astroway + async AsyncAstroway, na bázi 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 notifikacím e-mailem na stránce každého SDK (/sdk/<language>/)

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

Existuje sandbox režim?

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

Jaký je rate limit?

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 siderický zvěrokruh?

Ano. Předáš "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, definice, 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í

Ukládají se data o požadavcích?

API funguje stateless – data o datu/času/koordinátech narození nejsou po zpracování požadavku uložena. Logují se jen metadata: key_id, endpoint, timestamp, latency, kredity. Žádná osobní data.

Splňuje API požadavky GDPR?

Ano. Data nejsou ukládána. Pro uživatele z EU: žádné zpracování PII, žádné profilování, žádné cookies. API klíč je svázán s účtem, ne s koncovým uživatelem.

Jsou AI interpretace bezpečné?

AI endpointy (/interpret/*, /horoscope/*) mají vestavěné safety guardrails: zákaz medicínských, právních, finančních rad. Každá odpověď obsahuje disclaimer. Kompletní audit trail – pro enterprise compliance.

Podpora

Jak získat pomoc?

Závisí na plánu: Free – community, Indie – email (48 h), Starter – email (24 h), Pro – email (4 h), Business – email + Slack (1 h), Enterprise – vyhrazený manažer ve Slacku. Kontakty – na stránce Kontakty.

Existuje SLA?

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

Podobné názvy

Je AstroWay API (astroway.info) spojen s předplatným “Astroway” od astroway.life?

Ne. astroway.info a api.astroway.info – je to samostatná, nezávislá společnost. Poskytujeme astrologické API pro vývojáře (api.astroway.info), aplikaci pro koncové uživatele (app.astroway.info) a astrologické konzultace. Nemáme žádný vztah k spotřebitelskému astrologickému předplatnému, které propagují a účtují pod názvem “Astroway” přes astroway.life (e‑maily od no-reply@astroway.life, osoba “Celeste”, na bankovním výpisu – “Astroway”). Operátorem tohoto předplatného je TrafficLeader OÜ (Estonsko, také traffic-leader.com); související bílér SKYREAD.PRO – je to ABCMobile OÜ (Estonsko). Shoduje se jen podobná výslovnost názvu – jsou to různé společnosti.

Strhává mě “Astroway” – jak zrušit předplatné a získat peníze zpět?

Pokud vám jsou účtovány poplatky za předplatné “Astroway” (e‑maily od no-reply@astroway.life, na bankovním výpisu – “Astroway”), jedná se o jinou společnost, astroway.life, ne o nás. Nemáme přístup k vašemu účtu ani k platbám v této službě, takže nemůžeme je zrušit ani vrátit peníze. Jak postupovat:

1. Odpovězte přímo na e‑mail od no-reply@astroway.life a použijte odkaz “odhlásit se / zrušit” v jeho patičce.
2. Pokud nedostanete odpověď: obraťte se na svou banku nebo vydavatele karty (platba ve výpisu – “Astroway”; obchodník – TrafficLeader OÜ nebo ABCMobile OÜ / SKYREAD.PRO, Estonsko) a požádejte o blokaci dalších odečtů nebo o provedení chargebacku.