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

Загальні

Що таке AstroWay API?

Професійний HTTP API для астрологічних розрахунків. 865 ендпоінт з точністю до кутової секунди: натальні карти, синастрія, прогресії, дирекції, транзити, Human Design, астрокартографія, ректифікація, AI-інтерпретації. Усі розрахунки на сервері - жодних залежностей на стороні клієнта.

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

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

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

Точність планетарних позицій до ±1 кутової секунди, куспідів будинків - до ±1 кутової мінути. Проти NASA JPL Horizons медіанне відхилення 0.052″, усі 231 позиції в межах допуску; затемнення в межах хвилини від NASA 5-Millennium Eclipse Catalog.

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

Та сама точність до кутової секунди, яку ви очікуєте від професійного десктопного софту. Проти NASA JPL Horizons медіанне відхилення 0.052″; проти референсного виводу swetest від Astrodienst медіана 0.0013″, максимум 0.561″ (Chiron); затемнення в межах 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: експонує всі 865+ ендпоінтів як інструменти для 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.

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

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

Відповідь у JSON не залишає слідів: дата, час, координати й ім’я народження не зберігаються після обробки запиту. Виняток один: PDF-звіт із /v1/reports/* лежить файлом за своїм посиланням 24 години або стільки днів, скільки ви задали в retain_days (до 90), і його можна видалити раніше. Логуються лише метадані: key_id, ендпоінт, timestamp, latency, кредити.

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

Так. Дані зберігаються й обчислюються в Нюрнберзі, журнал запитів не містить параметрів запиту і живе 30 днів, а з будь-яким платним тарифом іде DPA за статтею 28, яку ви приймаєте в дашборді. Дані народження, які ви надсилаєте, є персональними даними, тож ми обробляємо їх як ваш процесор, а не вдаємо, що їх немає. Усе, що питає перевірка безпеки, з документом за кожною відповіддю: Довіра і обробка даних.

Чи є 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 з фінансовими гарантіями.

Схожі назви

Чи пов’язаний AstroWay API (astroway.info) з підпискою “Astroway” від astroway.life?

Ні. astroway.info та api.astroway.info - це окрема, незалежна компанія. Ми надаємо астрологічний API для розробників (api.astroway.info), застосунок для кінцевих користувачів (app.astroway.info) і консультації астролога. Ми не маємо жодного стосунку до споживчої астрологічної підписки, яку рекламують і списують під назвою “Astroway” через astroway.life (листи від no-reply@astroway.life, персона “Celeste”, у банківській виписці - “Astroway”). Оператор цієї підписки - TrafficLeader OÜ (Естонія, також traffic-leader.com); супутній білер SKYREAD.PRO - це ABCMobile OÜ (Естонія). Збігається лише схоже звучання назви - це різні компанії.

Мене списує “Astroway” - як скасувати підписку й повернути кошти?

Якщо вас списують за підписку “Astroway” (листи від no-reply@astroway.life, у банківській виписці - “Astroway”), це інша компанія, astroway.life, а не ми. Ми не маємо доступу до вашого акаунту чи платежів у цьому сервісі, тож не можемо їх скасувати чи повернути кошти. Як діяти:

1. Відповідайте напряму на лист від no-reply@astroway.life і скористайтеся посиланням “відписатися / скасувати” в його футері.
2. Якщо не реагують: зверніться до свого банку або емітента картки (платіж у виписці - “Astroway”; мерчант - TrafficLeader OÜ або ABCMobile OÜ / SKYREAD.PRO, Естонія) і попросіть заблокувати повторні списання або оформити повернення (chargeback).