Огляд

AstroWay API — це професійний backend для астрологічних обчислень як сервіс. 97 ендпоінтів на базі Swiss Ephemeris (WASM), з покриттям технік, яких немає у жодного конкурента: гармоніки, драконічні карти, CCG, сектори Гоклена, повний Human Design, ректифікація.

Для кого це

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

Для кого це не

• Горокопні віджети «рак на сьогодні» без контролю — AI-інтерпретації та гороскопи є (/interpret/*, /horoscope/*), але вони спроектовані як API для розробників, не як готовий віджет.
• Ведична астрологія як основна спеціалізація — у нас є Vedic divisional charts і nakshatras, але фокус продукту — західна астрологія. Для Vedic краще подивитись Prokerala або VedicAstroAPI.
• Таро/нумерологія — тільки астрологія і Human Design. I-Ching є як бонусний ендпоінт.

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

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

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

2. Точність Swiss Ephemeris

Усі розрахунки виконуються через Swiss Ephemeris, WASM-збірка. Точність:

• Планетарні позиції: ±1 кутова секунда
• Куспіди будинків: ±1 кутова мінута
• Порівняння з референсними даними Zet, Solar Fire, Astrodienst — розбіжностей у межах похибки методу.

3. 97 ендпоінтів — глибоке покриття західних технік

87 обчислювальних + 10 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.

Далі

• Швидкий старт — перший запит за 5 хвилин
• Автентифікація — як отримати і зберігати ключ
• Кредити та ліміти — як працює білінг
• Документація API — усі ендпоінти з інтерактивним playground