# Asztrológiai alkalmazások

Építesz egy astro alkalmazást a Co-Star, Sanctuary, The Pattern, Chani vagy Costar Compat stílusában? Az AstroWay API leváltja a Solar Fire ($495) licenc szükségességét, vagy a saját ephemeris motor megírását: {siteMeta.endpoints} endpointdal (születési horoszkópok, szinasztria, tranzitok, Human Design, AI-értelmezések), OpenAPI 3.1 specifikáció a típusos kliensek generálásához (TS / Python SDK a roadmapen), a Swiss Ephemeris pontossága – ugyanaz a motor, mint az Astrodienstben és a Keplerben.

## Tipikus architektúra

```
Felhasználó (böngésző / mobil)
     ↓
A te backended (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSON-válasz → renderelés a saját UI-dban
```

<Aside type="caution">
Soha ne helyezz API-kulcsot a frontend kódba. Az AstroWay API hívásainak a te backendeden vagy szerveroldali funkcióidon (Next.js API routes, Vercel Functions, AWS Lambda) keresztül kell menniük.
</Aside>

## Kulcsfontosságú endpointok asztrológiai alkalmazáshoz

### MVP (minimális termék)

| Endpoint | Kreditek | Mire való |
|---|---|---|
| `/v1/chart` | 20 | Születési horoszkóp generálása |
| `/v1/synastry` | 50 | Két ember összeillősége |
| `/v1/horoscope/daily` | 20 | Napi horoszkóp |

Három endpoint – és máris van egy működő terméked születési horoszkóppal, összeillőséggel és napi tartalommal.

### Bővített termék

| Endpoint | Kreditek | Mire való |
|---|---|---|
| `/v1/transits` | 50 | Aktuális tranzitok a születési horoszkópon |
| `/v1/solar-return` | 50 | Szolár (évi horoszkóp) |
| `/v1/progressions` | 50 | Másodlagos progressziók |
| `/v1/interpret/natal` | 50 | AI-értelmezés születési horoszkóphoz |
| `/v1/transit-calendar` | 100 | Tranzit események naptára |
| `/v1/human-design` | 50 | HD-horoszkóp |

### Prémium funkciók

| Endpoint | Kreditek | Mire való |
|---|---|---|
| `/v1/rectification` | 500 | Születési idő korrigálása |
| `/v1/acg` | 50 | Asztrokartográfia (hol érdemes élni) |
| `/v1/forecast-calendar` | 100 | Évi előrejelzés-heatmap |
| `/v1/group-synastry` | 100 | Csoportos összeillőség |

## Költségbecslés

### Szcenárió: 100 DAU (napi aktív felhasználók)

Feltételezzük, hogy az átlagos felhasználó naponta 3 műveletet hajt végre:

| Művelet | Endpoint | Kreditek | Kérések/nap | Kreditek/nap |
|---|---|---|---|---|
| Horoszkóp megtekintése | `/v1/chart` | 20 | 100 | 2 000 |
| Napi horoszkóp | `/v1/horoscope/daily` | 20 | 100 | 2 000 |
| Összeillőség | `/v1/synastry` | 50 | 30 | 1 500 |
| **Összesen** | | | **230** | **5 500/nap** |

**~165 000 kredit/hónap** (5 500 × 30) → a **Starter ($19/hó, 200 000 kredit)** tarifacsomag 21%-os tartalékkal, vagy az **Indie ($5/hó, 50 000 kredit)** a többlet ~$5-ért a további 110K kreditért.

### Szcenárió: MVP 20 DAU-val

| Művelet | Kreditek/nap |
|---|---|
| 20 horoszkóp | 400 |
| 20 napi horoszkóp | 400 |
| 5 szinasztria | 250 |
| **Összesen** | **1 050/nap** |

**~31 500 kredit/hónap** → az **Indie ($5/hó, 50 000 kredit)** tarifacsomag.

## Tippek

- **Születési horoszkópokat cache-elj** – a bemenet változatlan (a születési dátum nem változik), így az eredményt véglegesen cache-elheted a saját adatbázisodban
- **Napi horoszkópokat cache-elj egy napra** – a napi horoszkóp ugyanaz minden azonos jegyű ember számára, generáld egyszer és oszd szét
- **Sandbox-kulcsok** (`aw_test_*`) – fejlesztéshez, nem vonnak le krediteket
- **Codegen az OpenAPI 3.1-ből** – dobd be a `/v1/openapi.json`-t az `openapi-typescript`-be vagy `openapi-python-client`-be, és kapsz egy típusos klienst (kész SDK-k a roadmapen)

<CardGrid>
  <LinkCard title="Gyors kezdés →" href="/getting-started/" description="Első kérés 5 perc alatt" />
  <LinkCard title="Birth Chart API" href="/products/birth-chart-api/" description="Részletes születési horoszkóp API" />
  <LinkCard title="Árak" href="/pricing/" description="Ingyenestől az Enterprise-ig" />
</CardGrid>