Каталог AstroWay - це вже 726 ендпоінтів у 57 групах. На такому масштабі головне питання інтегратора не «чи вистачить покриття», а «як не загубитись». Ця стаття - карта: як каталог поділений на домени і як знайти потрібне за хвилину.
Один патерн на всі виклики
Section titled “Один патерн на всі виклики”Незалежно від домену, кожен розрахунковий ендпоінт має однакову форму:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonТіло - JSON із даними народження (дата, час, координати) або специфічними для техніки параметрами. Відповідь - завжди { "ok": true, "data": {...} } або { "ok": false, "error": {...} }. Жодних GraphQL, жодних окремих auth-flow на домен: один ключ у заголовку X-Api-Key, один формат відповіді.
Це означає, що обгортка, яку ти пишеш під натальну карту, підходить і для BaZi, і для рун - міняється тільки шлях і схема тіла.
Домени каталогу
Section titled “Домени каталогу”Каталог групується у великі домени. Ось карта з реальними лічильниками (числа беруться з маніфесту на кожному білді, тому тут вони завжди актуальні):
| Домен | Ендпоінтів | Що всередині |
|---|---|---|
| Західна астрологія | 179 | Натальна карта, аспекти, гідності, прогностика (транзити, прогресії, дирекції), horary, 4 елліністичні школи, сучасна психологічна, еволюційна, космобіологія |
| Ведична | 170 | Найбільший домен: nakshatras, dashas, divisional-карти (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Бодиграф, канали, ворота, тип/профіль/авторитет, інкарнаційний хрест |
| Таро | 66 | Три колоди: Rider-Waite-Smith, Marseille, Lenormand - розклади, значення, комбінації |
| Нумерологія | 50 | 5 систем по 10 розрахунків (піфагорійська, халдейська, дві кабалістичні, ведична) |
| Китайська + Мая | 39 | BaZi (чотири стовпи), Zi Wei Dou Shu, китайський зодіак і фен-шуй, календарі Мая |
| Гадання | 31 | Геомантія (Агріппа), руни Старшого Футарку, хіромантія (Cheiro), I Ching |
| Прикладні ніші | 50 | Wellness, астрологія тварин, бізнес, фінанси, сімейна |
| Звіти | 21 | Готові інтерпретації (natal, synastry), у HTML/PDF, з white-label брендуванням |
| Рендер | 14 | SVG/PNG колеса карт, bodygraph, транзитні кільця - без свого фронтенду |
| Dev-інструменти | 44 | Вебхуки, стрімінг у реальному часі, вбудовувані віджети, white-label |
Решта - AI-інтерпретації, гороскопи, довідкові ендпоінти (знаки, планети, аспекти) і системні (health, usage, openapi).
Ведична - окрема історія
Section titled “Ведична - окрема історія”170 ведичних ендпоінтів - це більше, ніж уся західна частина. Причина проста: ведична традиція формалізованіша. Там, де західна астрологія має один набір домів, ведична має 16 divisional-карт (varga), кілька систем dasha, десятки yogas із чіткими правилами. Кожне з цього - окремий ендпоінт із детермінованим результатом.
Якщо будуєш під індійський ринок, це ядро продукту, а не додаток.
Точність під усім цим
Section titled “Точність під усім цим”Незалежно від екзотики техніки, планетні позиції рахуються одним ядром на Swiss Ephemeris (WASM). Те саме ядро працює і в браузері нашого застосунку, і на сервері API - одна кодова база, жодного розходження. Розрахункові ендпоінти покриті 818 снапшот-тестами, які на кожному PR звіряються з еталонними джерелами. Детальніше про це - в окремій статті про CI-точність.
Як знайти потрібне
Section titled “Як знайти потрібне”Три шляхи, від найшвидшого:
- OpenAPI-довідник - /docs/api/ генерується напряму з прод-специфікації
openapi.json. Групи в сайдбарі = домени вище. Кожен ендпоінт має схему тіла, приклад і кнопку «спробувати». - MCP-каталог - якщо ти в Claude чи Cursor, увесь каталог доступний як набір інструментів через
mcp.astroway.info. Агент сам знаходить потрібний ендпоінт за описом. - Пошук по specifiкації -
curl https://api.astroway.info/v1/openapi.jsonвіддає повний машиночитний контракт. Зручно для кодогенерації власного клієнта.
Почати
Section titled “Почати”Ключ на dashboard/sign-up дає 10 000 кредитів на місяць - достатньо, щоб пройтись по десятках доменів і зрозуміти, що з цього твоє. Каталог не треба вивчати цілком: візьми свій домен, а решта чекатиме, коли знадобиться.
Той самий Swiss Ephemeris, що й у Solar Fire — у 4 рядках коду.
Безкоштовний ключ без картки. 5 000 викликів на місяць до першої оплати.