# Przegląd

**AstroWay API** — profesjonalny backend do obliczeń astrologicznych dostępny jako usługa.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpointów opartych na Swiss Ephemeris (WASM), obejmujących techniki niedostępne w żadnym innym konkurencyjnym rozwiązaniu: harmonie, mapy smocze, CCG, sektory Goklena, pełny Human Design, a także rektyfikację.

## Dla kogo to jest

1. **Deweloperzy aplikacji astrologicznych** (web, mobile), którzy potrzebują precyzyjnych i różnorodnych obliczeń bez własnej infrastruktury obliczeniowej.
2. **Firmy AI**, które integrują funkcje astrologiczne — dostępny natywny serwer MCP dla Claude, ChatGPT i innych agentów.
3. **Profesjonalni astrolodzy**, którzy budują własne narzędzia lub skrypty dla klientów.
4. **Badacze**, którzy potrzebują programowego dostępu do obliczeń w celach badawczych.
5. **Platformy treści**, które dodają funkcje astrologiczne do istniejącego produktu.

## Dla kogo to **nie** jest

- Gadżety „rak na dziś” bez kontroli — AI-interpretacje i horoskopy są dostępne (`/interpret/*`, `/horoscope/*`), ale zaprojektowane jako API dla deweloperów, a nie jako gotowe widgety.
- Astrologia wedyjska jako główna specjalizacja — dla projektów Vedic-first (systemy Dasha, Panchang, KP) lepsze będą Prokerala i VedicAstroAPI. Dla astrologii zachodniej + Human Design + rzadkich technik (rektyfikacja, harmonie, CCG) AstroWay bije konkurencję. Zobacz /compare/.
- Tarot/numerologia — tylko astrologia i Human Design. I-Ching dostępny jest jako bonusowy endpoint.

## Co sprawia, że AstroWay jest wyjątkowy

### 1. Rzadkie techniki w formacie API

| Technika | Do czego służy |
|---|---|
| **Harmoniczne mapy** (H2–H180) | Astrologia badawcza (metoda Johna Addeya) |
| **Mapa smocza** | Astrologia karmana/duchowa |
| **CCG (Cyclo-Carto-Graphy)** | Zaawansowana astrokartografia progresywna — technika premium Jima Lewisa |
| **Sektory Goklena** | Astrologia statystyczna, zastosowania akademickie |
| **Postępy trzeciorzędne** | Trzeci typ progresji — niszowa, ale ceniona technika |
| **Antysycje / kontr-antysycje** | Klasyczna technika hellenistyczna — odrodzenie tradycyjnych szkół |
| **Aspekty równoległe** | Aspekty w deklinacji — zaawansowane praktyki |
| **Rektyfikacja przez API** | Korekta czasu urodzenia — niezwykle cenny mechanizm |
| **Cykle planetarne** (koniunkcje) | Mundane astrologia — zdarzenia światowe |
| **Cykliczny indeks Barbault** | Mundane astrologia |
| **Minimum Algol** | Czasy gwiazd stałych — elektionalna astrologia |
| **Linie lokalnego przestrzeni** | Astrologia podobna do feng shui |
| **Łańcuchy dyspozycji** | Grafy sterowania — klasyczna technika |
| **Almuten figuris** | Średniowieczna technika — odrodzenie tradycji |

### 2. Precyzja Swiss Ephemeris — ten sam silnik, który napędza Solar Fire ($495), Kepler ($995), Astro Gold

Ten sam Swiss Ephemeris (LGPL), którego używają profesjonalni astrolodzy w Solar Fire, Kepler, Astro Gold i Janus od ponad 30 lat — tylko w wersji WASM i jako REST API, bez pośredniczącej marży. Precyzja:

- Pozycje planetarne: ±1 sekunda kątowa vs NASA JPL ephemeris
- Kuspidy domów: ±1 minuta kątowa
- Walidacja względem Zet 9, Solar Fire (własny ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — rozbieżności mieszczą się w granicach błędu metody (≤0.1″).

### 3. {siteMeta.endpoints} endpointów — głębokie pokrycie zachodnich technik

{siteMeta.westernCount} obliczeniowych endpointów zachodniej astrologii (4 szkoły: hellenistyczna, psychologiczna, ewolucyjna, kosmo-biologia) + AI-interpretacje + pełny Human Design. Głębokość zamiast rozproszenia na dziesiątki kierunków.

## Architektura

```
Twój aplikacja
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Obliczenia i zwrócenie JSON
```

- Obliczenia wykonywane są **po stronie serwera** — żadnych blobów WASM po stronie frontendu twojej aplikacji, żadnych problemów z licencjami Swiss Ephemeris.
- Stan po stronie serwera nie jest przechowywany — każde zapytanie jest samowystarczalne. Brak wycieku danych klientów.
- Klucze API są powiązane z planem, limitem rate limit i dziennym limitem kredytów. Monitorowanie przez dashboard.

## Co dalej

- [Szybki start](/getting-started/) — pierwsze zapytanie w 5 minut
- [Uwierzytelnianie](/authentication/) — jak uzyskać i przechowywać klucz
- [Kredyty i limity](/rate-limits-credits/) — jak działa billing
- [Dokumentacja API](/docs/api/) — wszystkie endpointy z interaktywnym playground