# Applicazioni astrologiche

Stai costruendo un'app astrologica come Co–Star, Sanctuary, The Pattern, Chani o Costar Compat? L'API AstroWay sostituisce la necessità di acquistare una licenza per Solar Fire ($495) o di scrivere il tuo motore di effemeridi: {siteMeta.endpoints} endpoint (carte natali, sinastria, transiti, Human Design, interpretazioni AI), OpenAPI 3.1 per generare client tipizzati (TS / Python SDK in roadmap), precisione Swiss Ephemeris — lo stesso motore usato da Astrodienst e Kepler.

## Architettura tipica

```
Utente (browser / mobile)
     ↓
Il tuo backend (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Risposta JSON → rendering nella tua UI
```

<Aside type="caution">
Non inserire mai la chiave API nel codice frontend. Le chiamate all'API AstroWay devono passare attraverso il tuo backend o funzioni server (route API di Next.js, Vercel Functions, AWS Lambda).
</Aside>

## Endpoint chiave per la tua app astrologica

### MVP (Minimum Viable Product)

| Endpoint | Crediti | Per cosa |
|---|---|---|
| `/v1/chart` | 20 | Generazione di una carta natale |
| `/v1/synastry` | 50 | Compatibilità tra due persone |
| `/v1/horoscope/daily` | 20 | Oroscopo giornaliero |

Tre endpoint e hai già un prodotto funzionante con carta natale, compatibilità e contenuti quotidiani.

### Prodotto avanzato

| Endpoint | Crediti | Per cosa |
|---|---|---|
| `/v1/transits` | 50 | Transiti attuali sulla carta natale |
| `/v1/solar-return` | 50 | Mappa solare (carta annuale) |
| `/v1/progressions` | 50 | Progressioni secondarie |
| `/v1/interpret/natal` | 50 | Interpretazione AI della carta natale |
| `/v1/transit-calendar` | 100 | Calendario degli eventi di transito |
| `/v1/human-design` | 50 | Mappa Human Design |

### Funzioni premium

| Endpoint | Crediti | Per cosa |
|---|---|---|
| `/v1/rectification` | 500 | Correzione dell'ora di nascita |
| `/v1/acg` | 50 | Astro-cartografia (dove vivere meglio) |
| `/v1/forecast-calendar` | 100 | Calendario annuale delle previsioni (heatmap) |
| `/v1/group-synastry` | 100 | Compatibilità di gruppo |

## Stima del budget

### Scenario: 100 DAU (Daily Active Users)

Supponiamo che l'utente medio effettui 3 azioni al giorno:

| Azione | Endpoint | Crediti | Richieste/giorno | Crediti/giorno |
|---|---|---|---|---|
| Visualizzazione carta | `/v1/chart` | 20 | 100 | 2 000 |
| Oroscopo giornaliero | `/v1/horoscope/daily` | 20 | 100 | 2 000 |
| Compatibilità | `/v1/synastry` | 50 | 30 | 1 500 |
| **Totale** | | | **230** | **5 500/giorno** |

**~165.000 crediti/mese** (5.500 × 30) → piano **Starter ($19/mese, 200.000 crediti)** con un margine del 21%, oppure **Indie ($5/mese, 50.000 crediti)** con pagamento extra di ~$5 per i 110.000 crediti aggiuntivi.

### Scenario: MVP con 20 DAU

| Azione | Crediti/giorno |
|---|---|
| 20 carte | 400 |
| 20 oroscopi | 400 |
| 5 sinastri | 250 |
| **Totale** | **1.050/giorno** |

**~31.500 crediti/mese** → piano **Indie ($5/mese, 50.000 crediti)**.

## Consigli

- **Cache delle carte natali** — l'input non cambia (la data di nascita rimane invariata), quindi puoi memorizzare il risultato in modo permanente nel tuo database
- **Cache degli oroscopi giornalieri** — l'oroscopo giornaliero è identico per tutti gli appartenenti allo stesso segno zodiacale, generalo una volta e distribuiscilo
- **Chiavi sandbox** (`aw_test_*`) — per lo sviluppo, non consumano crediti
- **Generazione di codice con OpenAPI 3.1** — punta `/v1/openapi.json` in `openapi-typescript` o `openapi-python-client` e ottieni un client tipizzato (SDK pronti in roadmap)

<CardGrid>
  <LinkCard title="Guida rapida →" href="/getting-started/" description="Fai la tua prima richiesta in 5 minuti" />
  <LinkCard title="Birth Chart API" href="/products/birth-chart-api/" description="Dettagli sulla carta natale" />
  <LinkCard title="Prezzi" href="/pricing/" description="Dal gratuito all'Enterprise" />
</CardGrid>