Часті запитання.

Загальні

Що таке AstroWay API?

Професійний HTTP API для астрологічних розрахунків. 705 ендпоінт на базі Swiss Ephemeris (WASM): натальні карти, синастрія, прогресії, дирекції, транзити, Human Design, астрокартографія, ректифікація, AI-інтерпретації. Усі розрахунки на сервері — жодних залежностей на стороні клієнта.

Для кого цей API?

Для розробників, які будують астрологічні застосунки (web/mobile), AI-компаній, що додають астрологічні функції, професійних астрологів зі скриптами, та дослідників, яким потрібен програмний доступ до обчислень.

Яка точність розрахунків?

Swiss Ephemeris забезпечує точність планетарних позицій до ±1 кутової секунди, куспідів будинків — до ±1 кутової мінути. Результати верифіковані проти Astrodienst (Astro.com), Solar Fire, Zet 9 та Kepler. Sub-arcsecond дрифт vs NASA JPL ephemeris і NASA 5-Millennium Eclipse Catalog.

Як AstroWay порівнюється з Astro.com або Solar Fire?

Ідентичний движок Swiss Ephemeris — той самий, що в Solar Fire ($495 ліцензія), Kepler ($995), Astro Gold ($29.99/міс) і Astrodienst (Astro.com). Валідовано проти NASA JPL ephemeris і офіційного swetest reference від Astrodienst. Sub-arcsecond дрифт (≤0.1″) на планетарних позиціях, ≤1 хвилина на затемненнях. Різниця: AstroWay — REST API від $5/міс замість one-time license або desktop GUI.

Які системи будинків підтримуються?

15 систем: Placidus (за замовчуванням), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC та Equal від MC. Передай відповідний код у параметрі houseSystem.

Кредити та оплата

Як працює кредитна система?

Кожен ендпоінт має фіксовану вартість у кредитах (від 10 до 500), залежно від складності розрахунку. Простий lookup — 10, натальна карта — 20, синастрія — 50, ректифікація — 500. Повна таблиця — на сторінці Тарифи.

Чи є безкоштовний тариф?

Так. Free план дає 10 000 кредитів/місяць, 10 req/min. Без вводу картки. Достатньо для оцінки продукту та прототипування.

Що буде, коли кредити закінчаться?

На Free — запити блокуються до наступного місяця (429 CREDITS_EXHAUSTED). На Indie/Starter/Pro/Business — включається overage: $5 / $3 / $2 за 10 000 додаткових кредитів.

Чи кешуються однакові запити?

Так. Ідентичний input протягом 5 хвилин повертається з кешу без списання кредитів. Підтверджується заголовком X-Cache: HIT.

Чи можна купити кредити без підписки?

Поки ні. Підписка дає передбачуваний бюджет і кращий rate limit. Pay-as-you-go планується.

Технічне

Які SDK доступні?

• MCP сервер ✅ зрелізено: npx -y @astroway/mcp — експонує всі 705+ ендпоінтів як інструменти для Claude Desktop, Cursor, GPT та інших MCP-сумісних AI-агентів
• TypeScript SDK ✅ зрелізено: npm install @astroway/sdk — типи + autocomplete з OpenAPI 3.1, retry + idempotency, Stainless-style errors
• Python SDK ✅ зрелізено: pip install astroway — sync Astroway + async AsyncAstroway, на базі httpx, PEP 561 typed
• PHP SDK ✅ зрелізено: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 заплановано — підпишіться на нотифікацію через email на сторінці кожного SDK (/sdk/<language>/)

Контракт API — стандартний REST + JSON, тож будь-який HTTP-клієнт працює без SDK. Postman collection і OpenAPI 3.1 spec доступні публічно.

Чи є sandbox-режим?

Так. Ключі aw_test_* не списують кредити і повертають ті ж результати. Ідеально для розробки та тестування.

Який rate limit?

Залежить від плану: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1 000 req/min. При перевищенні — 429 з заголовком Retry-After.

Чи підтримується sidereal зодіак?

Так. Передай "zodiacType": "sidereal" і опціонально "ayanamsaId" (за замовчуванням — Lahiri). Працює з усіма ендпоінтами.

Що таке Human Design ендпоінти?

12 ендпоінтів для розрахунку Human Design: тип, стратегія, авторитет, профіль, визначення, інкарнаційний хрест, канали, центри, Dream Rave, Hologenetic Profile, Penta (групова динаміка), часова чутливість. Найглибше покриття HD серед комерційних API.

Безпека та приватність

Чи зберігаються дані про запити?

API працює stateless — дані про дату/час/координати народження не зберігаються після обробки запиту. Логуються лише метадані: key_id, ендпоінт, timestamp, latency, кредити. Жодних персональних даних.

Чи відповідає API вимогам GDPR?

Так. Дані не зберігаються. Для користувачів з ЄС: ніякої обробки PII, ніякого профілювання, ніяких cookies. API key прив’язаний до акаунту, не до кінцевого користувача.

Чи є AI-інтерпретації безпечними?

AI-ендпоінти (/interpret/*, /horoscope/*) мають вбудовані safety guardrails: заборона медичних, юридичних, фінансових порад. Кожна відповідь включає disclaimer. Повний audit trail — для enterprise compliance.

Підтримка

Як отримати допомогу?

Залежить від плану: Free — community, Indie — email (48 год), Starter — email (24 год), Pro — email (4 год), Business — email + Slack (1 год), Enterprise — виділений менеджер у Slack. Контакти — на сторінці Контакти.

Чи є SLA?

Indie: 99% uptime. Starter та Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: custom SLA з фінансовими гарантіями.