FAQ answers

Ogólne

Co to jest AstroWay API?

Profesjonalny HTTP API do obliczeń astrologicznych. 771 endpoint oparty na Swiss Ephemeris: karty natalne, synastria, progresje, dyrekcje, tranzyty, Human Design, astrokartografia, rektifikacja, AI‑interpretacje. Wszystkie obliczenia odbywają się na serwerze – żadnych zależności po stronie klienta.

Dla kogo jest to API?

Dla deweloperów budujących aplikacje astrologiczne (web/mobile), firm AI dodających funkcje astrologiczne, profesjonalnych astrologów z własnymi skryptami oraz badaczy, którym potrzebny jest programowy dostęp do obliczeń.

Jaka jest dokładność obliczeń?

Swiss Ephemeris zapewnia dokładność pozycji planet do ±1 sekundy kątowej, cuspów domów – do ±1 minuty kątowej. Wyniki zweryfikowano względem Astrodienst (Astro.com), Solar Fire, Zet 9 oraz Kepler. Sub‑arcsecond drift w porównaniu z ephemeris NASA JPL i NASA 5‑Millennium Eclipse Catalog.

Jak AstroWay porównuje się z Astro.com lub Solar Fire?

Identyczny silnik Swiss Ephemeris – ten sam, co w Solar Fire (licencja $495), Kepler ($995), Astro Gold ($29.99/mies.) i Astrodienst (Astro.com). Zweryfikowano względem ephemeris NASA JPL i oficjalnego odniesienia swetest od Astrodienst. Sub‑arcsecond drift (≤0.1″) w pozycjach planetarnych, ≤1 minuta w zaćmieniach. Różnica: AstroWay – REST API od $5/mies. zamiast jednorazowej licencji lub desktopowego GUI.

Jakie systemy domów są obsługiwane?

15 systemów: Placidus (domyślnie), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski‑Pisa, Hindu Bhava, APC oraz Equal od MC. Przekaż odpowiedni kod w parametrze houseSystem.

Kredyty i płatności

Jak działa system kredytowy?

Każdy endpoint ma stałą cenę w kredytach (od 10 do 500), w zależności od złożoności obliczenia. Proste lookup – 10, karta natalna – 20, synastria – 50, rektifikacja – 500. Pełna tabela – na stronie Cennik.

Czy jest darmowy plan?

Tak. Plan Free daje 10 000 kredytów/miesiąc, 10 req/min. Bez podawania karty. Wystarczający do oceny produktu i prototypowania.

Co się stanie, gdy kredyty się wyczerpią?

W planie Free – zapytania są blokowane do następnego miesiąca (429 CREDITS_EXHAUSTED). W planach Indie/Starter/Pro/Business włącza się overage: $5 / $3 / $2 za dodatkowe 10 000 kredytów.

Czy identyczne zapytania są buforowane?

Tak. Identyczny input przez 5 minut zwracany jest z cache bez pobierania kredytów. Potwierdzane nagłówkiem X-Cache: HIT.

Czy można kupić kredyty bez subskrypcji?

Na razie nie. Subskrypcja zapewnia przewidywalny budżet i lepszy limit szybkości. Plan pay‑as‑you‑go jest w planach.

Techniczne

Jakie SDK są dostępne?

• MCP serwer ✅ zrealizowane: npx -y @astroway/mcp: eksponuje wszystkie 771+ endpointy jako narzędzia dla Claude Desktop, Cursor, GPT i innych agentów AI zgodnych z MCP
• TypeScript SDK ✅ zrealizowane: npm install @astroway/sdk: typy + autouzupełnianie z OpenAPI 3.1, retry + idempotency, błędy w stylu Stainless
• Python SDK ✅ zrealizowane: pip install astroway: sync Astroway + async AsyncAstroway, oparty na httpx, typowany PEP 561
• PHP SDK ✅ zrealizowane: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR‑18, middleware retry
• Go / Ruby / Rust 📋 w planie: subskrybuj powiadomienia e‑mail na stronie każdego SDK (/sdk/<language>/)

Kontrakt API – standardowy REST + JSON, więc każdy klient HTTP działa bez SDK. Kolekcja Postman i spec OpenAPI 3.1 są dostępne publicznie.

Czy istnieje tryb sandbox?

Tak. Klucze aw_test_* nie pobierają kredytów i zwracają te same wyniki. Idealne do rozwoju i testowania.

Jaki jest limit szybkości?

Zależy od planu: Free – 10, Indie – 30, Starter – 120, Pro – 400, Business – 1 000 req/min. Przy przekroczeniu – 429 z nagłówkiem Retry-After.

Czy obsługiwany jest zodiak sideralny?

Tak. Przekaż "zodiacType": "sidereal" i opcjonalnie "ayanamsaId" (domyślnie – Lahiri). Działa ze wszystkimi endpointami.

Co to są endpointy Human Design?

12 endpointów do obliczeń Human Design: typ, strategia, autorytet, profil, definicja, krzyż inkarnacyjny, kanały, centra, Dream Rave, Hologenetic Profile, Penta (dynamika grupowa), wrażliwość czasowa. Najgłębsze pokrycie HD wśród komercyjnych API.

Bezpieczeństwo i prywatność

Czy przechowywane są dane o zapytaniach?

API działa stateless – dane o dacie/godzinie/współrzędnych urodzenia nie są przechowywane po przetworzeniu zapytania. Logowane są tylko metadane: key_id, endpoint, timestamp, latency, kredyty. Brak danych osobowych.

Czy API spełnia wymagania GDPR?

Tak. Dane nie są przechowywane. Dla użytkowników z UE: żadnego przetwarzania PII, żadnego profilowania, żadnych ciasteczek. API key jest powiązany z kontem, nie z końcowym użytkownikiem.

Czy AI‑interpretacje są bezpieczne?

Endpointy AI (/interpret/*, /horoscope/*) mają wbudowane zabezpieczenia safety guardrails: zakaz udzielania porad medycznych, prawnych, finansowych. Każda odpowiedź zawiera disclaimer. Pełny audit trail – dla zgodności enterprise.

Wsparcie

Jak uzyskać pomoc?

Zależy od planu: Free – community, Indie – email (48 h), Starter – email (24 h), Pro – email (4 h), Business – email + Slack (1 h), Enterprise – dedykowany manager na Slacku. Kontakt – na stronie Kontakt.

Czy istnieje SLA?

Indie: 99 % uptime. Starter i Pro: 99,9 % uptime. Business: 99,95 % uptime. Enterprise: niestandardowe SLA z gwarancjami finansowymi.

Podobne nazwy

Czy AstroWay API (astroway.info) jest powiązany z subskrypcją “Astroway” od astroway.life?

Nie. astroway.info i api.astroway.info – to odrębna, niezależna firma. Dostarczamy astrologiczny API dla deweloperów (api.astroway.info), aplikację dla końcowych użytkowników (app.astroway.info) oraz konsultacje astrologiczne. Nie mamy żadnego związku z konsumencką subskrypcją astrologiczną, którą reklamują i pobierają pod nazwą “Astroway” przez astroway.life (maile od no-reply@astroway.life, postać “Celeste”, w wyciągu bankowym – “Astroway”). Operatorem tej subskrypcji jest TrafficLeader OÜ (Estonia, także traffic-leader.com); powiązany bilier SKYREAD.PRO – to ABCMobile OÜ (Estonia). Zbiega się jedynie podobne brzmienie nazwy – to różne firmy.

Obciążają mnie “Astroway” – jak anulować subskrypcję i odzyskać pieniądze?

Jeśli obciążają Cię za subskrypcję “Astroway” (maile od no-reply@astroway.life, w wyciągu bankowym – “Astroway”), to inna firma, astroway.life, a nie my. Nie mamy dostępu do Twojego konta ani płatności w tym serwisie, więc nie możemy ich anulować ani zwrócić pieniędzy. Co zrobić:

1. Odpowiedz bezpośrednio na mail od no-reply@astroway.life i użyj linku “unsubscribe / cancel” w jego stopce.
2. Jeśli nie reagują: skontaktuj się ze swoim bankiem lub wystawcą karty (płatność w wyciągu – “Astroway”; merchant – TrafficLeader OÜ lub ABCMobile OÜ / SKYREAD.PRO, Estonia) i poproś o zablokowanie kolejnych obciążeń lub o zwrot (chargeback).