# Астрологічні застосунки
Будуєш astro-додаток на кшталт Co-Star, Sanctuary, The Pattern, Chani чи Costar Compat? AstroWay API замінює потребу ліцензувати Solar Fire ($495) або писати свій движок ефемерид: {siteMeta.endpoints} ендпоінтів (натальні карти, синастрія, транзити, Human Design, AI-інтерпретації), OpenAPI 3.1 для генерації типізованих клієнтів (TS / Python SDK у roadmap), Swiss Ephemeris точність — той самий движок, що в Astrodienst і Kepler.
## Типова архітектура
```
Користувач (браузер / мобільний)
↓
Твій бекенд (Node.js / Python / PHP)
↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
↓
JSON-відповідь → рендеринг у твоєму UI
```
## Ключові ендпоінти для астро-застосунку
### MVP (мінімальний продукт)
| Ендпоінт | Кредити | Для чого |
|---|---|---|
| `/v1/chart` | 20 | Побудова натальної карти |
| `/v1/synastry` | 50 | Сумісність двох людей |
| `/v1/horoscope/daily` | 20 | Щоденний гороскоп |
Три ендпоінти — і в тебе вже працюючий продукт з натальною картою, сумісністю і щоденним контентом.
### Розширений продукт
| Ендпоінт | Кредити | Для чого |
|---|---|---|
| `/v1/transits` | 50 | Поточні транзити на натальну карту |
| `/v1/solar-return` | 50 | Соляр (річна карта) |
| `/v1/progressions` | 50 | Вторинні прогресії |
| `/v1/interpret/natal` | 50 | 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` | 20 | 100 | 2 000 |
| Сумісність | `/v1/synastry` | 50 | 30 | 1 500 |
| **Разом** | | | **230** | **5 500/день** |
**~165 000 кредитів/місяць** (5 500 × 30) → тариф **Starter ($19/міс, 200 000 кредитів)** із 21% запасом, або **Indie ($5/міс, 50 000)** з оплатою overage ~$5 за зайві 110K кредитів.
### Сценарій: MVP з 20 DAU
| Дія | Кредитів/день |
|---|---|
| 20 карт | 400 |
| 20 гороскопів | 400 |
| 5 синастрій | 250 |
| **Разом** | **1 050/день** |
**~31 500 кредитів/місяць** → тариф **Indie ($5/міс, 50 000 кредитів)**.
## Поради
- **Кешуй натальні карти** — вхід незмінний (дата народження не змінюється), тому результат можна кешувати назавжди у своїй БД
- **Гороскопи кешуй на день** — щоденний гороскоп однаковий для всіх людей одного знаку, генеруй раз і роздавай
- **Sandbox-ключі** (`aw_test_*`) — для розробки, не списують кредити
- **Codegen з OpenAPI 3.1** — тицьни `/v1/openapi.json` у `openapi-typescript` або `openapi-python-client` і отримай типізованого клієнта (готові SDK у roadmap)