Астрологічні застосунки

Будуєш astro-додаток на кшталт Co-Star, Sanctuary, The Pattern, Chani чи Costar Compat? AstroWay API замінює потребу ліцензувати Solar Fire ($495) або писати свій движок ефемерид: 760 ендпоінтів (натальні карти, синастрія, транзити, Human Design, AI-інтерпретації), OpenAPI 3.1 плюс опубліковані SDK для TypeScript, Python і PHP, Swiss Ephemeris точність - той самий движок, що в Astrodienst і Kepler.

Типова архітектура

Користувач (браузер / мобільний)
     ↓
Твій бекенд (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSON-відповідь → рендеринг у твоєму UI

Обережно

Ніколи не кладіть API-ключ у фронтенд-код. Виклики AstroWay API мають проходити через ваш бекенд або серверні функції (Next.js API routes, Vercel Functions, AWS Lambda).

Ключові ендпоінти для астро-застосунку

MVP (мінімальний продукт)

Ендпоінт	Кредити	Для чого
/v1/chart	20	Побудова натальної карти
/v1/synastry	50	Сумісність двох людей
/v1/horoscope/daily	50	Щоденний гороскоп

Три ендпоінти - і в тебе вже працюючий продукт з натальною картою, сумісністю і щоденним контентом.

Розширений продукт

Ендпоінт	Кредити	Для чого
/v1/transits	50	Поточні транзити на натальну карту
/v1/solar-return	50	Соляр (річна карта)
/v1/progressions	50	Вторинні прогресії
/v1/interpret/natal	100	AI-інтерпретація натальної карти
/v1/transit-calendar	100	Календар транзитних подій
/v1/human-design	50	HD-карта

Преміум-функції

Ендпоінт	Кредити	Для чого
/v1/rectification	500	Корекція часу народження
/v1/acg	50	Астрокартографія (де краще жити)
/v1/forecast-calendar	100	Річний прогноз-heatmap
/v1/group-synastry	100	Групова сумісність

Оцінка бюджету

Сценарій: 100 DAU (daily active users)

Припускаємо, що середній користувач робить 3 дії на день:

Дія	Ендпоінт	Кредити	Запитів/день	Кредитів/день
Перегляд карти	/v1/chart	20	100	2 000
Щоденний гороскоп	/v1/horoscope/daily	50	100	5 000
Сумісність	/v1/synastry	50	30	1 500
Разом			230	8 500/день

~255 000 кредитів/місяць (8 500 × 30) → тариф Pro ($59/міс, 800 000 кредитів) із великим запасом, або Starter ($19/міс, 200 000) з доплатою ~$30 overage за зайві 55K ($5 за кожні 10 000 понад квоту). Кеш денного гороскопу (один текст на знак, не на користувача) знімає з цього рахунку 4 850 кредитів на день і повертає сценарій у Starter.

Сценарій: MVP з 20 DAU

Дія	Кредитів/день
20 карт	400
20 гороскопів	1 000
5 синастрій	250
Разом	1 650/день

~49 500 кредитів/місяць - тариф Indie ($5/міс, 50 000 кредитів) покриває це на 99%, тобто без запасу: перший же приріст трафіку впирається в overage або в Starter. З кешем гороскопів (12 викликів на добу замість 20) виходить ~35 000 і запас з’являється.

Поради

• Кешуй натальні карти: вхід незмінний (дата народження не змінюється), тому результат можна кешувати назавжди у своїй БД
• Гороскопи кешуй на день: щоденний гороскоп однаковий для всіх людей одного знаку, генеруй раз і роздавай
• Sandbox-ключі (aw_test_*): для розробки, не списують кредити
• Типізовані клієнти: постав @astroway/sdk, astroway чи astroway/sdk; для іншої мови згенеруй клієнта з /v1/openapi.json через openapi-typescript або openapi-python-client

Швидкий старт → Перший запит за 5 хвилин

Birth Chart API Детально про натальну карту

Тарифи Від безкоштовного до Enterprise