# Astrologické aplikace
Buduješ astro-aplikaci podobně jako Co-Star, Sanctuary, The Pattern, Chani nebo Costar Compat? AstroWay API ti ušetří nutnost licence na Solar Fire ($495) nebo psaní vlastního efemeridového enginu: {siteMeta.endpoints} endpointů (nativní mapy, synastrie, transity, Human Design, AI interpretace), OpenAPI 3.1 pro generování typovaných klientů (TS / Python SDK v roadmap), Swiss Ephemeris přesnost — stejný engine jako v Astrodienst a Kepler.
## Typická architektura
```
Uživatel (prohlížeč / mobil)
↓
Tvůj backend (Node.js / Python / PHP)
↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
↓
JSON odpověď → vykreslení ve tvém UI
```
## Klíčové endpointy pro astro-aplikaci
### MVP (minimální produkt)
| Endpoint | Kredity | K čemu slouží |
|---|---|---|
| `/v1/chart` | 20 | Vytvoření nativní mapy |
| `/v1/synastry` | 50 | Kompatibilita dvou lidí |
| `/v1/horoscope/daily` | 20 | Denní horoskop |
Tři endpointy — a už máš funkční produkt s nativní mapou, kompatibilitou a denním obsahem.
### Rozšířený produkt
| Endpoint | Kredity | K čemu slouží |
|---|---|---|
| `/v1/transits` | 50 | Aktuální transity na nativní mapu |
| `/v1/solar-return` | 50 | Solární návrat (roční mapa) |
| `/v1/progressions` | 50 | Sekundární progrese |
| `/v1/interpret/natal` | 50 | AI interpretace nativní mapy |
| `/v1/transit-calendar` | 100 | Kalendář transitních událostí |
| `/v1/human-design` | 50 | HD mapa |
### Prémiové funkce
| Endpoint | Kredity | K čemu slouží |
|---|---|---|
| `/v1/rectification` | 500 | Korekce času narození |
| `/v1/acg` | 50 | Astrokartografie (kde se lépe žít) |
| `/v1/forecast-calendar` | 100 | Roční prognóza-heatmap |
| `/v1/group-synastry` | 100 | Skupinová kompatibilita |
## Odhad rozpočtu
### Scénář: 100 DAU (daily active users)
Předpokládáme, že průměrný uživatel provede 3 akce denně:
| Akce | Endpoint | Kredity | Počet požadavků/den | Kreditů/den |
|---|---|---|---|---|
| Zobrazení mapy | `/v1/chart` | 20 | 100 | 2 000 |
| Denní horoskop | `/v1/horoscope/daily` | 20 | 100 | 2 000 |
| Kompatibilita | `/v1/synastry` | 50 | 30 | 1 500 |
| **Celkem** | | | **230** | **5 500/den** |
**~165 000 kreditů/měsíc** (5 500 × 30) → tarif **Starter ($19/měs, 200 000 kreditů)** s 21% rezervou, nebo **Indie ($5/měs, 50 000)** s platbou overage ~$5 za dalších 110K kreditů.
### Scénář: MVP s 20 DAU
| Akce | Kreditů/den |
|---|---|
| 20 map | 400 |
| 20 horoskopů | 400 |
| 5 synastií | 250 |
| **Celkem** | **1 050/den** |
**~31 500 kreditů/měsíc** → tarif **Indie ($5/měs, 50 000 kreditů)**.
## Tipy
- **Kejšuj nativní mapy** — vstup je neměnný (datum narození se nemění), takže výsledek můžeš kešovat navždy ve své databázi
- **Horoskopy kešuj na den** — denní horoskop je stejný pro všechny lidi stejného znamení, vygeneruj jednou a rozdej
- **Sandboxové klíče** (`aw_test_*`) — pro vývoj, neodečítají kredity
- **Codegen z OpenAPI 3.1** — pošli `/v1/openapi.json` do `openapi-typescript` nebo `openapi-python-client` a získej typovaného klienta (připravené SDK v roadmap)