FAQ answers

Algemeen

Wat is de AstroWay API?

Professionele HTTP API voor astrologische berekeningen. 714 endpoints gebaseerd op Swiss Ephemeris (WASM): natalkaarten, synastrie, progressies, directies, transits, Human Design, astrocartografie, rectificatie, AI-interpretaties. Alle berekeningen vinden op de server plaats — geen afhankelijkheden aan de clientkant.

Voor wie is deze API?

Voor ontwikkelaars die astrologische applicaties (web/mobile) bouwen, AI-bedrijven die astrologische functies toevoegen, professionele astrologen met scripts en onderzoekers die programmatische toegang tot berekeningen nodig hebben.

Hoe nauwkeurig zijn de berekeningen?

Swiss Ephemeris zorgt voor een nauwkeurigheid van planetaire posities tot ±1 boogseconde, huizenknopen tot ±1 boogminuut. Resultaten zijn geverifieerd tegen Astrodienst (Astro.com), Solar Fire, Zet 9 en Kepler. Sub-boogseconde drift ten opzichte van NASA JPL ephemeris en NASA 5-Millennium Eclipse Catalog.

Hoe vergelijkt AstroWay zich met Astro.com of Solar Fire?

Identieke Swiss Ephemeris-engine — dezelfde als in Solar Fire ($495 licentie), Kepler ($995), Astro Gold ($29.99/maand) en Astrodienst (Astro.com). Geverifieerd tegen NASA JPL ephemeris en de officiële swetest-referentie van Astrodienst. Sub-boogseconde drift (≤0.1″) op planetaire posities, ≤1 minuut op eclipsen. Verschil: AstroWay is een REST API vanaf $5/maand in plaats van een one-time license of desktop GUI.

Welke huizensystemen worden ondersteund?

15 systemen: Placidus (standaard), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentrisch, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC en Equal van MC. Geef de juiste code door in de parameter houseSystem.

Credits en betaling

Hoe werkt het creditsysteem?

Elk endpoint heeft een vaste prijs in credits (van 10 tot 500), afhankelijk van de complexiteit van de berekening. Eenvoudige lookup — 10, natalkaart — 20, synastrie — 50, rectificatie — 500. De volledige tabel vind je op de pagina Prijzen.

Is er een gratis tarief?

Ja. Het Free-plan geeft 10.000 credits/maand, 10 req/min. Geen creditcard nodig. Voldoende om het product te evalueren en te prototypen.

Wat gebeurt er als de credits op zijn?

Bij Free worden verzoeken geblokkeerd tot de volgende maand (429 CREDITS_EXHAUSTED). Bij Indie/Starter/Pro/Business wordt overage toegepast: $5 / $3 / $2 per 10.000 extra credits.

Worden identieke verzoeken gecached?

Ja. Identieke input binnen 5 minuten wordt uit de cache teruggegeven zonder creditverbruik. Bevestigd met de header X-Cache: HIT.

Kun je credits kopen zonder abonnement?

Nog niet. Een abonnement geeft een voorspelbaar budget en een betere rate limit. Een pay-as-you-go-plan staat op de planning.

Technisch

Welke SDK’s zijn beschikbaar?

• MCP-server ✅ uitgebracht: npx -y @astroway/mcp — exposeert alle 714+ endpoints als tools voor Claude $1, Cursor, GPT en andere MCP-compatibele AI-agenten
• TypeScript SDK ✅ uitgebracht: npm install @astroway/sdk — types + autocomplete met OpenAPI 3.1, retry + idempotency, Stainless-style errors
• Python SDK ✅ uitgebracht: pip install astroway — sync Astroway + async AsyncAstroway, gebaseerd op httpx, PEP 561 typed
• PHP SDK ✅ uitgebracht: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 gepland — meld je aan voor notificaties via e-mail op de pagina van elke SDK (/sdk/<language>/)

De API-contract is standaard REST + JSON, dus elke HTTP-client werkt zonder SDK. Postman-collectie en OpenAPI 3.1-spec zijn publiek beschikbaar.

Is er een sandbox-modus?

Ja. Sleutels met aw_test_* verbruiken geen credits en geven dezelfde resultaten terug. Ideaal voor ontwikkeling en testen.

Wat is de rate limit?

Afhankelijk van het plan: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1.000 req/min. Bij overschrijding — 429 met header Retry-After.

Wordt de siderische dierenriem ondersteund?

Ja. Geef "zodiacType": "sidereal" en optioneel "ayanamsaId" door (standaard — Lahiri). Werkt met alle endpoints.

Wat zijn de Human Design endpoints?

12 endpoints voor het berekenen van Human Design: type, strategie, autoriteit, profiel, definitie, incarnatiecross, kanalen, centra, Dream Rave, Hologenetic Profile, Penta (groepsdynamiek), tijdgevoeligheid. De diepste dekking van HD onder commerciële API’s.

Beveiliging en privacy

Worden verzoekgegevens opgeslagen?

De API werkt stateless — gegevens over geboortedatum/tijd/coördinaten worden niet opgeslagen na verwerking. Alleen metadata wordt gelogd: key_id, endpoint, timestamp, latency, credits. Geen persoonlijke gegevens.

Voldoet de API aan GDPR?

Ja. Gegevens worden niet opgeslagen. Voor gebruikers uit de EU: geen verwerking van PII, geen profiling, geen cookies. API-sleutel is gekoppeld aan een account, niet aan een eindgebruiker.

Zijn AI-interpretaties veilig?

AI-endpoints (/interpret/*, /horoscope/*) hebben ingebouwde safety guardrails: verbod op medisch, juridisch en financieel advies. Elke respons bevat een disclaimer. Volledige audit trail voor enterprise compliance.

Ondersteuning

Hoe krijg je hulp?

Afhankelijk van het plan: Free — community, Indie — e-mail (48 uur), Starter — e-mail (24 uur), Pro — e-mail (4 uur), Business — e-mail + Slack (1 uur), Enterprise — toegewijde manager in Slack. Contactgegevens vind je op de pagina Contact.

Is er een SLA?

Indie: 99% uptime. Starter en Pro: 99,9% uptime. Business: 99,95% uptime. Enterprise: custom SLA met financiële garanties.