# Astrologische applicaties

Bouw je een astro-app zoals Co-Star, Sanctuary, The Pattern, Chani of Costar Compat? De AstroWay API vervangt de noodzaak om Solar Fire ($495) te licentiëren of je eigen efemeriden-engine te schrijven: {siteMeta.endpoints} endpoints (natalkaarten, synastrie, transits, Human Design, AI-interpretaties), OpenAPI 3.1 voor het genereren van getypeerde clients (TS/Python SDK in roadmap), Swiss Ephemeris-nauwkeurigheid — dezelfde engine als bij Astrodienst en Kepler.

## Typische architectuur

```
Gebruiker (browser / mobiel)
     ↓
Jouw backend (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSON-antwoord → rendering in je UI
```

<Aside type="caution">
Plaats nooit een API-sleutel in frontend-code. Oproepen naar de AstroWay API moeten via je backend of serverfuncties verlopen (Next.js API-routes, Vercel Functions, AWS Lambda).
</Aside>

## Belangrijkste endpoints voor een astro-app

### MVP (minimaal levensvatbaar product)

| Endpoint | Credits | Voor wat |
|---|---|---|
| `/v1/chart` | 20 | Natalkaart genereren |
| `/v1/synastry` | 50 | Compatibiliteit tussen twee mensen |
| `/v1/horoscope/daily` | 20 | Dagelijkse horoscoop |

Drie endpoints — en je hebt al een werkend product met een natalkaart, compatibiliteit en dagelijkse content.

### Uitgebreid product

| Endpoint | Credits | Voor wat |
|---|---|---|
| `/v1/transits` | 50 | Huidige transits op de natalkaart |
| `/v1/solar-return` | 50 | Zonnejaarkaart |
| `/v1/progressions` | 50 | Secundaire progressies |
| `/v1/interpret/natal` | 50 | AI-interpretatie van de natalkaart |
| `/v1/transit-calendar` | 100 | Kalender met transitgebeurtenissen |
| `/v1/human-design` | 50 | HD-kaart |

### Premium-functies

| Endpoint | Credits | Voor wat |
|---|---|---|
| `/v1/rectification` | 500 | Tijd van geboorte corrigeren |
| `/v1/acg` | 50 | Astrocartografie (waar is het beter om te wonen) |
| `/v1/forecast-calendar` | 100 | Jaarlijkse forecast-heatmap |
| `/v1/group-synastry` | 100 | Groepscompatibiliteit |

## Budgetraming

### Scenario: 100 DAU (daily active users)

We gaan ervan uit dat een gemiddelde gebruiker 3 acties per dag uitvoert:

| Actie | Endpoint | Credits | Verzoeken/dag | Credits/dag |
|---|---|---|---|---|
| Kaart bekijken | `/v1/chart` | 20 | 100 | 2.000 |
| Dagelijkse horoscoop | `/v1/horoscope/daily` | 20 | 100 | 2.000 |
| Compatibiliteit | `/v1/synastry` | 50 | 30 | 1.500 |
| **Totaal** | | | **230** | **5.500/dag** |

**~165.000 credits/maand** (5.500 × 30) → tarief **Starter ($19/maand, 200.000 credits)** met 21% marge, of **Indie ($5/maand, 50.000 credits)** met extra kosten van ~$5 voor de extra 110K credits.

### Scenario: MVP met 20 DAU

| Actie | Credits/dag |
|---|---|
| 20 kaarten | 400 |
| 20 horoscopen | 400 |
| 5 synastrieën | 250 |
| **Totaal** | **1.050/dag** |

**~31.500 credits/maand** → tarief **Indie ($5/maand, 50.000 credits)**.

## Tips

- **Cache natalkaarten** — de invoer is onveranderlijk (geboortedatum verandert niet), dus het resultaat kun je permanent in je database cachen
- **Cache dagelijkse horoscopen** — de dagelijkse horoscoop is voor iedereen met hetzelfde sterrenbeeld hetzelfde, genereer het één keer en deel het
- **Sandbox-sleutels** (`aw_test_*`) — voor ontwikkeling, verbruiken geen credits
- **Codegen met OpenAPI 3.1** — gooi `/v1/openapi.json` in `openapi-typescript` of `openapi-python-client` en je krijgt een getypeerde client (kant-en-klare SDK's in de roadmap)

<CardGrid>
  <LinkCard title="Snel starten →" href="/getting-started/" description="Eerste verzoek binnen 5 minuten" />
  <LinkCard title="Birth Chart API" href="/products/birth-chart-api/" description="Details over de natalkaart" />
  <LinkCard title="Tarieven" href="/pricing/" description="Van gratis tot Enterprise" />
</CardGrid>