# Přehled

**AstroWay API** je profesionální backend pro astrologické výpočty jako služba.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} koncových bodů založených na Swiss Ephemeris (WASM) s pokrytím technik, které nemá žádný konkurent: harmonie, dračí mapy, CCG, Gauquelinovy sektory, plný Human Design, rectifikace.

## Pro koho to je

1. **Vývojáři astrologických aplikací** (web, mobilní) potřebující přesné a rozmanité výpočty bez vlastní výpočetní infrastruktury.
2. **AI společnosti**, které integrují astrologické funkce — k dispozici je nativní MCP server pro Clauda, ChatGPT a další agenty.
3. **Profesionální astrologové**, kteří si budují vlastní nástroje nebo skripty pro klienty.
4. **Výzkumníci**, kteří potřebují programový přístup k výpočtům pro statistická šetření.
5. **Content platformy**, které přidávají astrologické funkce nad stávající produkt.

## Pro koho to **není**

- Horoskopové widgety „dnešek pro Rak“ bez kontroly — AI interpretace a horoskopy jsou k dispozici (`/interpret/*`, `/horoscope/*`), ale jsou navrženy jako API pro vývojáře, nikoli jako hotové widgety.
- Védská astrologie jako hlavní specializace — pro projekty zaměřené na Vedic (Dasha systémy, Panchang, KP) jsou lepší Prokerala a VedicAstroAPI. Pro západní astrologii + Human Design + vzácné techniky (rectifikace, harmonie, CCG) AstroWay vítězí. Podívej se na /compare/.
- Tarot/ numerologie — pouze astrologie a Human Design. I-Ching je k dispozici jako bonusový endpoint.

## Co dělá AstroWay jedinečným

### 1. Vzácné techniky v API formátu

| Technika | K čemu slouží |
|---|---|
| **Harmonické mapy** (H2–H180) | Výzkumná astrologie (metoda Johna Addeyho) |
| **Dračí mapa** | Karmická/duševní astrologie |
| **CCG (Cyclo-Carto-Graphy)** | Progresivní astrokartografie — prémiová technika Jima Lewise |
| **Gauquelinovy sektory** | Statistická astrologie, akademické využití |
| **Terciární progrese** | Třetí typ progresí — niszová, ale ceněná |
| **Antiscie / Kontra-antiscie** | Klasická helénistická technika — obnova tradičních škol |
| **Paralelní aspekty** | Aspekty podle deklinace — pokročilé praktiky |
| **Rectifikace přes API** | Korekce času narození — extrémně cenné |
| **Planetární cykly** (konjunkce) | Mundánní astrologie — světové události |
| **Cyklický index Barbo** | Mundánní astrologie |
| **Minimum Algolu** | Časy stálic — elektivní astrologie |
| **Linie místního prostoru** | Feng-shui podobná směrná astrologie |
| **Řetězce disposice** | Grafy řízení — klasická technika |
| **Almutén figuris** | Středověká technika — obnova tradic |

### 2. Přesnost Swiss Ephemeris — stejný engine jako v Solar Fire ($495), Kepler ($995), Astro Gold

Stejný Swiss Ephemeris (LGPL), který používají profesionální astrologové v Solar Fire, Kepler, Astro Gold a Janus již 30+ let — pouze ve verzi WASM a jako REST API, bez prostřednického navyšování cen. Přesnost:

- Planetární pozice: ±1 úhlová vteřina vs. NASA JPL ephemeris
- Kuspidy domů: ±1 úhlová minuta
- Validace proti Zet 9, Solar Fire (proprietární ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — odchylky v rámci chyby metody (≤0.1″).

### 3. {siteMeta.endpoints} koncových bodů — hluboké pokrytí západní astrologie

{siteMeta.westernCount} výpočetních koncových bodů západní astrologie (4 školy: helénistická, moderní psychologická, evoluční, kosmobiologie) + AI interpretace + plný Human Design. Hloubka místo rozptýlení do desítek směrů.

## Architektura

```
Tvůj aplikace
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Výpočet a návrat JSON
```

- Výpočty probíhají **na serveru** — žádné WASM bloby na frontendu tvé aplikace, žádná licenční omezení Swiss Ephemeris.
- Stav na straně serveru se neukládá — každý požadavek je samostatný. Žádné úniky dat o klientech.
- API klíče jsou vázány na tarif, limit rychlosti a denní zůstatek kreditů. Monitorování přes dashboard.

## Dále

- [Rychlý start](/getting-started/) — první požadavek za 5 minut
- [Autentizace](/authentication/) — jak získat a ukládat klíč
- [Kredity a limity](/rate-limits-credits/) — jak funguje billing
- [Dokumentace API](/docs/api/) — všechny koncové body s interaktivním playgroundem