# Aplicaciones astrológicas

¿Estás construyendo una app de astrología como Co-Star, Sanctuary, The Pattern, Chani o Costar Compat? La API de AstroWay elimina la necesidad de licenciar Solar Fire ($495) o desarrollar tu propio motor de efemérides: {siteMeta.endpoints} endpoints (cartas natales, sinastría, tránsitos, Human Design, interpretaciones con IA), OpenAPI 3.1 para generar clientes tipados (TS / Python SDK en roadmap), precisión con Swiss Ephemeris — el mismo motor que usan Astrodienst y Kepler.

## Arquitectura típica

```
Usuario (navegador / móvil)
     ↓
Tu backend (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Respuesta JSON → renderizado en tu UI
```

<Aside type="caution">
Nunca coloques la clave de API en el código frontend. Las llamadas a la API de AstroWay deben pasar por tu backend o funciones serverless (rutas de API de Next.js, Vercel Functions, AWS Lambda).
</Aside>

## Endpoints clave para tu app astrológica

### MVP (producto mínimo viable)

| Endpoint | Créditos | Para qué |
|---|---|---|
| `/v1/chart` | 20 | Generar carta natal |
| `/v1/synastry` | 50 | Compatibilidad entre dos personas |
| `/v1/horoscope/daily` | 20 | Horóscopo diario |

Tres endpoints y ya tienes un producto funcional con carta natal, compatibilidad y contenido diario.

### Producto avanzado

| Endpoint | Créditos | Para qué |
|---|---|---|
| `/v1/transits` | 50 | Tránsitos actuales sobre la carta natal |
| `/v1/solar-return` | 50 | Solar (carta anual) |
| `/v1/progressions` | 50 | Progresiones secundarias |
| `/v1/interpret/natal` | 50 | Interpretación con IA de la carta natal |
| `/v1/transit-calendar` | 100 | Calendario de eventos de tránsitos |
| `/v1/human-design` | 50 | Carta de Human Design |

### Funciones premium

| Endpoint | Créditos | Para qué |
|---|---|---|
| `/v1/rectification` | 500 | Rectificación de hora de nacimiento |
| `/v1/acg` | 50 | Astrocartografía (dónde vivir mejor) |
| `/v1/forecast-calendar` | 100 | Calendario de pronósticos anual (heatmap) |
| `/v1/group-synastry` | 100 | Compatibilidad grupal |

## Estimación de presupuesto

### Escenario: 100 usuarios activos diarios (DAU)

Asumimos que el usuario promedio realiza 3 acciones al día:

| Acción | Endpoint | Créditos | Peticiones/día | Créditos/día |
|---|---|---|---|---|
| Ver carta | `/v1/chart` | 20 | 100 | 2 000 |
| Horóscopo diario | `/v1/horoscope/daily` | 20 | 100 | 2 000 |
| Compatibilidad | `/v1/synastry` | 50 | 30 | 1 500 |
| **Total** | | | **230** | **5 500/día** |

**~165 000 créditos/mes** (5 500 × 30) → tarifa **Starter ($19/mes, 200 000 créditos)** con un 21% de margen, o **Indie ($5/mes, 50 000)** con pago por exceso de ~$5 por los 110K créditos adicionales.

### Escenario: MVP con 20 DAU

| Acción | Créditos/día |
|---|---|
| 20 cartas | 400 |
| 20 horóscopos | 400 |
| 5 sinastrías | 250 |
| **Total** | **1 050/día** |

**~31 500 créditos/mes** → tarifa **Indie ($5/mes, 50 000 créditos)**.

## Consejos

- **Cachea las cartas natales** — la entrada no cambia (la fecha de nacimiento es fija), así que puedes guardarla para siempre en tu base de datos
- **Cachea los horóscopos por día** — el horóscopo diario es el mismo para todos los de un mismo signo, genera una vez y distribuye
- **Claves de sandbox** (`aw_test_*`) — para desarrollo, no consumen créditos
- **Generación de código con OpenAPI 3.1** — usa `/v1/openapi.json` con `openapi-typescript` o `openapi-python-client` y obtén un cliente tipado (SDK listos en roadmap)

<CardGrid>
  <LinkCard title="Iniciación rápida →" href="/getting-started/" description="Tu primera petición en 5 minutos" />
  <LinkCard title="API de Carta Natal" href="/products/birth-chart-api/" description="Detalles sobre la carta natal" />
  <LinkCard title="Precios" href="/pricing/" description="Desde gratuito hasta Enterprise" />
</CardGrid>