# Огляд

**AstroWay API** — це професійний backend для астрологічних обчислень як сервіс.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} ендпоінтів на базі Swiss Ephemeris (WASM), з покриттям технік, яких немає у жодного конкурента: гармоніки, драконічні карти, CCG, сектори Гоклена, повний Human Design, ректифікація.

## Для кого це

1. **Розробники астрологічних застосунків** (web, mobile), яким потрібні точні й різноманітні розрахунки без власної обчислювальної інфраструктури.
2. **AI-компанії**, що вбудовують астрологічні функції — є нативний MCP-сервер для Claude, ChatGPT та інших агентів.
3. **Професійні астрологи**, які будують власні інструменти або скрипти для клієнтів.
4. **Дослідники**, яким потрібен програмний доступ до обчислень для статистичних досліджень.
5. **Контент-платформи**, що додають астрологічні фічі поверх існуючого продукту.

## Для кого це **не**

- Горокопні віджети «рак на сьогодні» без контролю — AI-інтерпретації та гороскопи є (`/interpret/*`, `/horoscope/*`), але вони спроектовані як API для розробників, не як готовий віджет.
- Ведична астрологія як основна спеціалізація — для Vedic-first проєктів (Dasha-системи, Panchang, KP) Prokerala та VedicAstroAPI сильніші. Для західної астрології + Human Design + рідкісних технік (ректифікація, гармоніки, CCG) AstroWay — beats them. Дивись /compare/.
- Таро/нумерологія — тільки астрологія і Human Design. I-Ching є як бонусний ендпоінт.

## Що робить AstroWay унікальним

### 1. Рідкісні техніки в API-форматі

| Техніка | Навіщо |
|---|---|
| **Гармонійні карти** (H2–H180) | Дослідницька астрологія (метод Джона Аддея) |
| **Драконічна карта** | Кармічна/душевна астрологія |
| **CCG (Cyclo-Carto-Graphy)** | Прогресована астрокартографія — преміум-техніка Джима Льюїса |
| **Сектори Гоклена** | Статистична астрологія, академічне використання |
| **Третинні прогресії** | Третій тип прогресій — нішева, але цінується |
| **Антисції / контр-антисції** | Класична елліністична техніка — відродження традиційних шкіл |
| **Паралельні аспекти** | Аспекти по декалінації — просунуті практики |
| **Ректифікація через API** | Корекція часу народження — надвисока цінність |
| **Планетарні цикли** (кон'юнкції) | Мундайн-астрологія — світові події |
| **Циклічний індекс Барбо** | Мундайн-астрологія |
| **Мінімум Алголь** | Часи нерухомих зір — електіональна астрологія |
| **Лінії локального простору** | Феншуй-подібна напрямна астрологія |
| **Ланцюжки диспозиції** | Графи керування — класична техніка |
| **Альмутен figuris** | Середньовічна техніка — традиційне відродження |

### 2. Точність Swiss Ephemeris — той самий движок, що в Solar Fire ($495), Kepler ($995), Astro Gold

Той самий Swiss Ephemeris (LGPL), яким користуються професійні астрологи в Solar Fire, Kepler, Astro Gold і Janus уже 30+ років — тільки в WASM-збірці й як REST API, без посередницької націнки. Точність:

- Планетарні позиції: ±1 кутова секунда vs NASA JPL ephemeris
- Куспіди будинків: ±1 кутова мінута
- Валідація проти Zet 9, Solar Fire (proprietary ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — розбіжностей у межах похибки методу (≤0.1″).

### 3. {siteMeta.endpoints} ендпоінтів — глибоке покриття західних технік

{siteMeta.westernCount} обчислювальних ендпоінтів західної астрології (4 школи Hellenistic, modern psychological, evolutionary, cosmobiology) + AI-інтерпретації + повний Human Design. Глибина замість розпорошування по десятках напрямків.

## Архітектура

```
Твій застосунок
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Розрахунок і повернення JSON
```

- Розрахунки виконуються **на сервері** — ніяких WASM-блобів на фронтенді твого застосунку, ніяких ліцензійних питань Swiss Ephemeris.
- Стан на стороні сервера не зберігається — кожен запит самодостатній. Ніякого витоку даних про клієнтів.
- Ключі API прив'язані до плану, rate limit і денного балансу кредитів. Моніторинг через dashboard.

## Далі

- [Швидкий старт](/getting-started/) — перший запит за 5 хвилин
- [Автентифікація](/authentication/) — як отримати і зберігати ключ
- [Кредити та ліміти](/rate-limits-credits/) — як працює білінг
- [Документація API](/docs/api/) — усі ендпоінти з інтерактивним playground