# Áttekintés

**AstroWay API** — egy profi backend az asztrológiai számításokhoz, mint szolgáltatás.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} végpontot kínál a Swiss Ephemeris (WASM) alapján, olyan technikákkal, amelyek nincsenek meg a versenytársaknál: harmóniák, sárkányképek, CCG, Hoksen szektora, teljes Human Design, rektifikáció.

## Kinek szól

1. **Asztrológiai alkalmazások fejlesztői** (web, mobil), akik pontos és változatos számításokat igényelnek saját számítástechnikai infrastruktúra nélkül.
2. **AI-vállalatok**, amelyek asztrológiai funkciókat építenek be — van natív MCP-szerver a Claude, ChatGPT és más ügynökök számára.
3. **Professzionális asztrológusok**, akik saját eszközöket vagy scripteket építenek ügyfeleik számára.
4. **Kutatók**, akik programozott hozzáférést igényelnek a számításokhoz statisztikai kutatásokhoz.
5. **Tartalommegosztó platformok**, amelyek asztrológiai funkciókat adnak a meglévő termékekhez.

## Kinek nem szól

- Horoszkóp widgetek "rák ma" kontroll nélkül — AI-értelmezések és horoszkópok vannak (`/interpret/*`, `/horoscope/*`), de azok API-ként vannak tervezve fejlesztők számára, nem kész widgetként.
- Védikus asztrológia mint fő specializáció — a Vedic-first projektekhez (Dasha-rendszerek, Panchang, KP) a Prokerala és a VedicAstroAPI erősebb. A nyugati asztrológia + Human Design + ritka technikák (rektifikáció, harmóniák, CCG) esetében az AstroWay jobb. Lásd /compare/.
- Tarot/numerológia — csak asztrológia és Human Design. I-Ching van bónusz végpontként.

## Mi teszi az AstroWay-t egyedivé

### 1. Ritka technikák API-formátumban

| Technika | Miért |
|---|---|
| **Harmóniai térképek** (H2–H180) | Kutatási asztrológia (John Addey módszere) |
| **Sárkánykép** | Karmikus/lelki asztrológia |
| **CCG (Ciklo-Kartográfia)** | Fejlett asztrokartográfia — prémium technika Jim Lewis-től |
| **Hoksen szektora** | Statisztikai asztrológia, akadémiai használat |
| **Harmadik progresszió** | Harmadik típusú progresszió — niche, de értékes |
| **Antiszciák / kontra-antiszciák** | Klasszikus hellenisztikus technika — hagyományos iskolák feltámasztása |
| **Párhuzamos aspektok** | Aspektok deklináció szerint — fejlett gyakorlatok |
| **Rektifikáció API-n keresztül** | Születési idő korrekció — nagyon magas érték |
| **Bolygóciklusok** (konjunkciók) | Mundán asztrológia — világesemények |
| **Ciklikus index Barbo** | Mundán asztrológia |
| **Algoritmus minimum** | Mozdulatlan csillagok ideje — elektionális asztrológia |
| **Helyi tér vonalai** | Feng shui-szerű irányított asztrológia |
| **Diszpozíciós láncok** | Irányítási grafikonok — klasszikus technika |
| **Almuten figuris** | Középkori technika — hagyományos feltámasztás |

### 2. Pontos Swiss Ephemeris — ugyanaz a motor, mint a Solar Fire ($495), Kepler ($995), Astro Gold

Ugyanaz a Swiss Ephemeris (LGPL), amit a professzionális asztrológusok használnak a Solar Fire, Kepler, Astro Gold és Janus alkalmazásokban már 30+ éve — csak WASM-gyűjteményben és REST API-ként, közvetítői felárral. Pontosság:

- Bolygópozíciók: ±1 szögmásodperc vs NASA JPL ephemeris
- Házkupeck: ±1 szögmásodperc
- Validálás a Zet 9, Solar Fire (saját ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold ellen — eltérések a módszer hibájának határain belül (≤0.1″).

### 3. {siteMeta.endpoints} végpont — mély lefedettség nyugati technikákhoz

{siteMeta.westernCount} számítási végpont nyugati asztrológiához (4 iskola Hellenistic, modern pszichológiai, evolúciós, cosmobiology) + AI-értelmezések + teljes Human Design. Mélység helyett szétszóródás tucatnyi irányba.

## Architektúra

```
A te alkalmazásod
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Számítás és JSON-válasz
```

- Számítások a **szerveren** történnek — nincs WASM-blob a frontendeden, nincs licenszprobléma a Swiss Ephemeris-szel.
- Állapot a szerver oldalán nem tárolódik — minden kérés önmagában áll. Nincs adatszivárgás az ügyfelekről.
- API-kulcsok a csomaghoz, sebességkorlátozás és napi hitelkerethez vannak kötve. Monitorozás a dashboardon keresztül.

## Tovább

- [Gyors kezdés](/getting-started/) — első kérés 5 perc alatt
- [Hitelesítés](/authentication/) — hogyan szerezd meg és tárold a kulcsot
- [Hitelkeret és korlátok](/rate-limits-credits/) — hogyan működik a számlázás
- [API-dokumentáció](/docs/api/) — összes végpont interaktív playgrounddal