# Bouw met de astrologische API AstroWay

Source: https://astroway.info/nl/developers/
Language: nl
Updated: 2026-05-28

Astrologie-API · v1

700+ endpoints, drie eigen SDK's, Swiss Ephemeris-accuratie. Anoniem tarief - start zonder sleutel.

[Gratis sleutel verkrijgen](https://api.astroway.info/dashboard/sign-up) Snelle start 10K kredieten/mnd · zonder kaart

## Snelle start

Ontvang een dagelijkse horoscoop zonder API-sleutel:

```
curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
```

### Registreer een gratis sleutel

[Krijg een gratis sleutel - 10K credits/maand, zonder kaart](https://api.astroway.info/dashboard/sign-up)

### Eerste verzoek met uw sleutel

```
curl -G "https://api.astroway.info/v1/chart" \
-H "X-Api-Key: aw_live_…" \
--data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
--data-urlencode "lat=50.45" --data-urlencode "lon=30.52"
```

Kijk [tarieven](https://astroway.info/shop/) voor limieten van tarieven en kosten van credits per endpoint.

## Authenticatie

Drie tarieven. Kies de jouwe.

| tarief | Authenticatie | Limieten | Watersterrenbeeld |
| --- | --- | --- | --- |
| **anoniem** | zonder sleutel | alleen /v1/embed/* · 30 verzoeken/uur per IP | ja |
| **Gratis sleutel** | `X-Api-Key: aw_live_…` | 10K credits/maand | ja |
| **Betaald** | `X-Api-Key: aw_live_…` | Indie 50K / Starter 200K / Pro 800K / Business 3,5M | nee (Pro+) |

### Domeinbinding

Betalingssleutels worden gekoppeld aan één domein tijdens het eerste verzoek. U kunt dit zelf wijzigen in uw dashboard, maximaal 3 keer per maand. Het installeren van de WordPress-plugin stuurt automatisch de X-AstroWay-Site-URL-header - zonder code wijzigingen.

### Foutafhandeling

- `401` — Ontbrekende of ongeldige X-Api-Key
- `402` — tarief bevat deze endpoint niet (bijv. HD-endpoint zonder HD Pack)
- `403` — domeinmismatch (gebonden domein ≠ Origin-kop)
- `429` — Limiet van verzoeken overschreden of maandelijkse kredieten opgebruikt (Retry-After-kop is ingesteld)

## Ingebouwde widgets

Directe iframe - werkt op elke HTML-website, zonder JS-loader. Anoniem tarief, 30 verzoeken/uur per IP van de bezoeker.

### Dagelijkse horoscoop

```
<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
width="100%" height="320" loading="lazy" frameborder="0"></iframe>
```

### Wiel van de geboortehoroscoop

```
<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
width="600" height="600" loading="lazy" frameborder="0"></iframe>
```

### Dagelijkse Tarot kaart

```
<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
width="400" height="500" loading="lazy" frameborder="0"></iframe>
```

### Maanfase

```
<iframe src="https://api.astroway.info/v1/embed/moon-phase"
width="320" height="320" loading="lazy" frameborder="0"></iframe>
```

### Installatie op WordPress

Installeer [AstroWay-plugin voor WP ↗](https://wordpress.org/plugins/astroway/) - Tier 1-widgets zonder configuratie, kortingen voor kopiëren, optionele API-sleutel voor Tier 2/3.

## Officiële SDK

Drie eigen SDK's. Volledige typeveiligheid, gegenereerd uit OpenAPI 3.1. MIT-licentie. Met herhalingen, idempotent.

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
npm install @astroway/sdk
```

```
import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · gegenereerd uit OpenAPI 3.1

### Python

astroway · v1.1.0

```
pip install astroway
```

```
from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
datetime="1990-06-15T14:30:00+03:00",
lat=50.45, lon=30.52,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · sync + async · Pydantic-modellen · py.typed

### PHP

astroway/sdk · v1.1.0

```
composer require astroway/sdk
```

```
use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · PSR-18 HTTP-client · Guzzle-promises

### WordPress

WordPress website? De gratis plugin [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) voegt geboortekaarten, horoscopen, Tarot, numerologie en Human Design toe via shortcodes en Gutenberg blokken - zonder code. Werkt anoniem of met uw API-sleutel.

```
[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]
```

### LLM / AI-agents

We publiceren [/llms.txt ↗](https://api.astroway.info/llms.txt) voor detectie door AI-agents. De familie van endpoints `/v1/context/*` retourneert LLM-geoptimaliseerde XML voor direct consumptie door ChatGPT / Claude / Gemini integraties.

### MCP-server (Pro+)

Native Model Context Protocol server op mcp.astroway.info - verbind met Claude Desktop of elke MCP-client om de volledige API in dialoogmodus te vragen. Inbegrepen in Pro en Business tarieven.
