# Overzicht

**AstroWay API** is een professionele backend voor astrologische berekeningen als service.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpoints op basis van Swiss Ephemeris (WASM), met dekking van technieken die geen enkele concurrent biedt: harmonische kaarten, draconische kaarten, CCG, Gauquelin-sectoren, volledige Human Design, rectificatie.

## Voor wie is dit

1. **Ontwikkelaars van astrologische toepassingen** (web, mobile) die nauwkeurige en gevarieerde berekeningen nodig hebben zonder eigen rekeninfrastructuur.
2. **AI-bedrijven** die astrologische functies integreren — er is een native MCP-server voor Claude, ChatGPT en andere agents.
3. **Professionele astrologen** die hun eigen tools of scripts voor klanten bouwen.
4. **Onderzoekers** die programmeertoegang nodig hebben tot berekeningen voor statistisch onderzoek.
5. **Contentplatforms** die astrologische functies toevoegen aan hun bestaande product.

## Voor wie is dit **niet**

- Horoscoop-widgets zoals "Ram voor vandaag" zonder controle — AI-interpretaties en horoscopen zijn er wel (`/interpret/*`, `/horoscope/*`), maar ze zijn ontworpen als API voor ontwikkelaars, niet als kant-en-klare widget.
- Vedische astrologie als hoofdspecialisatie — voor Vedic-first projecten (Dasha-systemen, Panchang, KP) zijn Prokerala en VedicAstroAPI sterker. Voor westerse astrologie + Human Design + zeldzame technieken (rectificatie, harmonischen, CCG) verslaat AstroWay hen. Zie /compare/.
- Tarot/nummologie — alleen astrologie en Human Design. I-Ching is beschikbaar als bonusendpoint.

## Wat maakt AstroWay uniek

### 1. Zeldzame technieken in API-formaat

| Techniek | Waarom |
|---|---|
| **Harmonische kaarten** (H2–H180) | Onderzoeksastrologie (John Addey-methode) |
| **Draconische kaart** | Karma/ziel-astrologie |
| **CCG (Cyclo-Carto-Graphy)** | Geavanceerde astrokartografie — premiumtechniek van Jim Lewis |
| **Gauquelin-sectoren** | Statistische astrologie, academisch gebruik |
| **Tertiaire progressies** | Derde type progressies — niche maar gewaardeerd |
| **Antiscia / contra-antiscia** | Klassieke hellenistische techniek — herleving van traditionele scholen |
| **Parallelle aspecten** | Aspecten op decilatie — geavanceerde praktijken |
| **Rectificatie via API** | Correctie van geboortetijd — extreem waardevol |
| **Planetaire cycli** (conjuncties) | Mundane astrologie — wereldgebeurtenissen |
| **Cyclische index van Barbault** | Mundane astrologie |
| **Minimum van Algol** | Tijden van vaste sterren — electieve astrologie |
| **Lijnen van lokale ruimte** | Feng shui-achtige richtingsastrologie |
| **Dispositieketens** | Beheergrafen — klassieke techniek |
| **Almutens figuris** | Middeleeuwse techniek — traditionele herleving |

### 2. Nauwkeurigheid van Swiss Ephemeris — dezelfde engine als in Solar Fire ($495), Kepler ($995), Astro Gold

Dezelfde Swiss Ephemeris (LGPL) die professionele astrologen al 30+ jaar gebruiken in Solar Fire, Kepler, Astro Gold en Janus — maar dan als WASM-build en REST API, zonder tussenliggende opslag. Nauwkeurigheid:

- Planetaire posities: ±1 boogseconde vs NASA JPL ephemeris
- Huisculminaties: ±1 boogminuut
- Validatie tegen Zet 9, Solar Fire (proprietary ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — afwijkingen binnen de methode-errormarge (≤0.1″).

### 3. {siteMeta.endpoints} endpoints — diepgaande dekking van westerse technieken

{siteMeta.westernCount} berekeningsendpoints voor westerse astrologie (4 scholen: Hellenistisch, modern psychologisch, evolutionair, cosmobiologie) + AI-interpretaties + volledige Human Design. Diepgang in plaats van verspreiding over tientallen richtingen.

## Architectuur

```
Jouw applicatie
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Berekening en retour JSON
```

- Berekeningen vinden **op de server** plaats — geen WASM-blobs in de frontend van jouw applicatie, geen licentieproblemen met Swiss Ephemeris.
- Status wordt niet op de server opgeslagen — elke request is self-contained. Geen datalekken over klanten.
- API-sleutels zijn gekoppeld aan het abonnement, rate limit en dagelijkse creditbalans. Monitoring via dashboard.

## Verder

- [Snelle start](/getting-started/) — eerste request in 5 minuten
- [Authenticatie](/authentication/) — hoe je een sleutel krijgt en opslaat
- [Credits en limieten](/rate-limits-credits/) — hoe de facturering werkt
- [API-documentatie](/docs/api/) — alle endpoints met interactieve playground
