FAQ answers

Ogólne

Co to jest AstroWay API?

Profesjonalne HTTP API do obliczeń astrologicznych. 714 endpointów opartych na Swiss Ephemeris (WASM): horoskopy urodzeniowe, synastria, progresje, dyrekcje, tranzyty, Human Design, astrokartografia, rektyfikacja, interpretacje AI. Wszystkie obliczenia wykonywane są po stronie serwera — brak zależności po stronie klienta.

Dla kogo jest to API?

Dla programistów tworzących aplikacje astrologiczne (web/mobile), firm AI dodających funkcje astrologiczne, profesjonalnych astrologów z własnymi skryptami oraz badaczy potrzebujących programowego dostępu do obliczeń.

Jaka jest dokładność obliczeń?

Swiss Ephemeris zapewnia dokładność pozycji planetarnych do ±1 sekundy kątowej, a kąty domów do ±1 minuty kątowej. Wyniki zweryfikowane względem Astrodienst (Astro.com), Solar Fire, Zet 9 oraz Kepler. Dryf sub-sekundowy względem efemeryd NASA JPL i NASA 5-Millennium Eclipse Catalog.

Jak AstroWay wypada na tle Astro.com lub Solar Fire?

Ten sam silnik Swiss Ephemeris — ten sam, co w Solar Fire ($495 licencja), Kepler ($995), Astro Gold ($29.99/mies.) i Astrodienst (Astro.com). Zweryfikowany względem efemeryd NASA JPL i oficjalnego narzędzia referencyjnego swetest od Astrodienst. Dryf sub-sekundowy (≤0.1″) w pozycjach planetarnych, ≤1 minuta w zaćmieniach. Różnica: AstroWay to REST API od $5/mies. zamiast jednorazowej licencji lub desktopowego GUI.

Jakie systemy domów są obsługiwane?

15 systemów: Placidus (domyślny), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentryczny, 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 obliczeń. Prosty lookup — 10, horoskop urodzeniowy — 20, synastria — 50, rektyfikacja — 500. Pełna tabela dostępna na stronie Cennik.

Czy istnieje darmowy plan?

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

Co się stanie, gdy skończą się kredyty?

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

Czy identyczne zapytania są cache’owane?

Tak. Ten sam input w ciągu 5 minut jest zwracany z cache’a bez pobierania kredytów. Potwierdza to nagłówek X-Cache: HIT.

Czy można kupić kredyty bez subskrypcji?

Na razie nie. Subskrypcja daje przewidywalny budżet i lepsze limity. Plan pay-as-you-go jest planowany.

Techniczne

Jakie SDK są dostępne?

• Serwer MCP ✅ wydany: npx -y @astroway/mcp — eksponuje wszystkie 714+ endpointów jako narzędzia dla Claude $1, Cursor, GPT i innych agentów MCP
• TypeScript SDK ✅ wydany: npm install @astroway/sdk — typy + autouzupełnianie z OpenAPI 3.1, retry + idempotencja, błędy w stylu Stainless
• Python SDK ✅ wydany: pip install astroway — sync Astroway + async AsyncAstroway, oparte na httpx, PEP 561 typed
• PHP SDK ✅ wydany: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 planowane — zapisz się na powiadomienie przez email na stronie każdego SDK (/sdk/<language>/)

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

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 zapytań?

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

Czy obsługiwany jest zodiak siderealny?

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), czułość czasowa. Najgłębsze pokrycie HD wśród komercyjnych API.

Bezpieczeństwo i prywatność

Czy dane zapytań są przechowywane?

API działa w trybie stateless — dane o dacie/czasie/koordynatach urodzenia nie są przechowywane po przetworzeniu zapytania. Logowane są jedynie metadane: key_id, endpoint, timestamp, latency, kredyty. Brak danych osobowych.

Czy API jest zgodne z RODO?

Tak. Dane nie są przechowywane. Dla użytkowników z UE: brak przetwarzania PII, brak profilowania, brak cookies. Klucz API jest powiązany z kontem, a nie z końcowym użytkownikiem.

Czy interpretacje AI są bezpieczne?

Endpointy AI (/interpret/*, /horoscope/*) mają wbudowane zabezpieczenia: blokada porad medycznych, prawnych i finansowych. Każda odpowiedź zawiera klauzulę wyłączenia odpowiedzialności. Pełny audit trail — dla compliance enterprise.

Wsparcie

Jak uzyskać pomoc?

Zależy od planu: Free — społeczność, Indie — email (48 godz.), Starter — email (24 godz.), Pro — email (4 godz.), Business — email + Slack (1 godz.), Enterprise — dedykowany menedżer w Slack. Kontakty na stronie Kontakt.

Czy istnieje SLA?

Indie: 99% uptime. Starter i Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: custom SLA z gwarancjami finansowymi.