# Aplicații astrologice

Vrei să construiești o aplicație astro precum Co-Star, Sanctuary, The Pattern, Chani sau Costar Compat? AstroWay API elimină necesitatea de a licenția Solar Fire ($495) sau de a-ți dezvolta propriul motor de efemeride: {siteMeta.endpoints} de endpoint-uri (hărți natale, sinastrie, tranzite, Human Design, interpretări AI), OpenAPI 3.1 pentru generarea de clienți tipizați (TS / Python SDK în roadmap), precizia Swiss Ephemeris — același motor folosit de Astrodienst și Kepler.

## Arhitectura tipică

```
Utilizator (browser / mobil)
     ↓
Backend-ul tău (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Răspuns JSON → randare în UI-ul tău
```

<Aside type="caution">
Nu pune niciodată cheia API în codul frontend. Apelurile către API-ul AstroWay trebuie să treacă prin backend-ul sau funcțiile server-side (Next.js API routes, Vercel Functions, AWS Lambda).
</Aside>

## Endpoint-uri cheie pentru aplicații astrologice

### MVP (produs minim viabil)

| Endpoint | Credite | Pentru |
|---|---|---|
| `/v1/chart` | 20 | Generarea hărții natale |
| `/v1/synastry` | 50 | Compatibilitatea dintre două persoane |
| `/v1/horoscope/daily` | 20 | Horoscop zilnic |

Trei endpoint-uri și deja ai un produs funcțional cu hartă natală, compatibilitate și conținut zilnic.

### Produs avansat

| Endpoint | Credite | Pentru |
|---|---|---|
| `/v1/transits` | 50 | Tranzitele curente asupra hărții natale |
| `/v1/solar-return` | 50 | Hartă solară (anuală) |
| `/v1/progressions` | 50 | Progresii secundare |
| `/v1/interpret/natal` | 50 | Interpretare AI a hărții natale |
| `/v1/transit-calendar` | 100 | Calendar cu evenimente de tranzit |
| `/v1/human-design` | 50 | Hartă Human Design |

### Funcții premium

| Endpoint | Credite | Pentru |
|---|---|---|
| `/v1/rectification` | 500 | Corecția orei de naștere |
| `/v1/acg` | 50 | Astrocartografie (unde este mai bine să locuiești) |
| `/v1/forecast-calendar` | 100 | Hartă anuală de prognoză |
| `/v1/group-synastry` | 100 | Compatibilitatea în grup |

## Estimarea bugetului

### Scenariu: 100 DAU (utilizatori activi zilnic)

Presupunem că utilizatorul mediu face 3 acțiuni pe zi:

| Acțiune | Endpoint | Credite | Cereri/zi | Credite/zi |
|---|---|---|---|---|
| Vizualizare hartă | `/v1/chart` | 20 | 100 | 2 000 |
| Horoscop zilnic | `/v1/horoscope/daily` | 20 | 100 | 2 000 |
| Compatibilitate | `/v1/synastry` | 50 | 30 | 1 500 |
| **Total** | | | **230** | **5 500/zi** |

**~165 000 credite/lună** (5 500 × 30) → tarif **Starter ($19/lună, 200 000 credite)** cu un surplus de 21%, sau **Indie ($5/lună, 50 000 credite)** cu plată suplimentară de ~$5 pentru cele 110K credite în plus.

### Scenariu: MVP cu 20 DAU

| Acțiune | Credite/zi |
|---|---|
| 20 hărți | 400 |
| 20 horoscoape | 400 |
| 5 sinastrii | 250 |
| **Total** | **1 050/zi** |

**~31 500 credite/lună** → tarif **Indie ($5/lună, 50 000 credite)**.

## Sfaturi

- **Cochează hărțile natale** — intrarea este neschimbată (data nașterii nu se modifică), deci rezultatul poate fi stocat pe termen nelimitat în baza ta de date
- **Cochează horoscoapele pe zi** — horoscopul zilnic este același pentru toți oamenii dintr-un anumit semn zodiacal, generează-l o singură dată și distribuie-l
- **Chei Sandbox** (`aw_test_*`) — pentru dezvoltare, nu consumă credite
- **Generare de cod din OpenAPI 3.1** — trimite `/v1/openapi.json` către `openapi-typescript` sau `openapi-python-client` și obține un client tipizat (SDK-uri gata făcute în roadmap)

<CardGrid>
  <LinkCard title="Start rapid →" href="/getting-started/" description="Prima cerere în 5 minute" />
  <LinkCard title="API Hartă Nativă" href="/products/birth-chart-api/" description="Detalii despre harta natală" />
  <LinkCard title="Prețuri" href="/pricing/" description="De la gratuit până la Enterprise" />
</CardGrid>
