FAQ answers

Algemeen

Wat is AstroWay API?

Een professionele HTTP API voor astrologische berekeningen. 771 endpoints op basis van Swiss Ephemeris: geboortehoroscopen, synastrie, progressies, directies, transits, Human Design, astrocartografie, rectificatie, AI-interpretaties. Alle berekeningen op de server - geen client-side afhankelijkheden.

Voor wie is deze API?

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

Wat is de nauwkeurigheid van de berekeningen?

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

Hoe vergelijkt AstroWay 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 reference van Astrodienst. Sub-boogseconde drift (≤0.1″) bij planeetposities, ≤1 minuut bij eclipses. Verschil: AstroWay is een REST API vanaf $5/maand in plaats van een eenmalige licentie of desktop GUI.

Welke huizen systemen worden ondersteund?

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

Credits en betaling

Hoe werkt het creditsysteem?

Elke endpoint heeft een vaste kosten in credits (van 10 tot 500), afhankelijk van de complexiteit van de berekening. Eenvoudige lookup - 10, geboortehoroscoop - 20, synastrie - 50, rectificatie - 500. Volledige tabel - op de pagina Tarieven.

Is er een gratis abonnement?

Ja. Free plan geeft 10 000 credits/maand, 10 req/min. Zonder kaartinvoer. Voldoende voor productevaluatie en prototyping.

Wat gebeurt er als de credits op zijn?

Op Free - verzoeken worden geblokkeerd tot de volgende maand (429 CREDITS_EXHAUSTED). Op Indie/Starter/Pro/Business - overage wordt ingeschakeld: $5 / $3 / $2 voor 10 000 extra credits.

Worden identieke verzoeken gecached?

Ja. Identieke input binnen 5 minuten wordt uit de cache teruggegeven zonder credits in rekening te brengen. Bevestigd met de header X-Cache: HIT.

Kan ik credits kopen zonder abonnement?

Nog niet. Een abonnement geeft een voorspelbaar budget en een hogere rate limit. Pay-as-you-go staat gepland.

Technisch

Welke SDK’s zijn beschikbaar?

• MCP server ✅ uitgebracht: npx -y @astroway/mcp: exposeert alle 771+ endpoints als tools voor Claude Desktop, Cursor, GPT en andere MCP-compatibele AI-agents
• 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: abonneer je op notificaties via e-mail op de pagina van elke SDK (/sdk/<language>/)

Het 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 aw_test_* brengen geen credits in rekening en geven dezelfde resultaten. 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 de header Retry-After.

Wordt de siderische dierenriem ondersteund?

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

Wat zijn de Human Design endpoints?

12 endpoints voor Human Design berekeningen: type, strategie, autoriteit, profiel, definitie, incarnatiekruis, kanalen, centra’s, Dream Rave, Hologenetic Profile, Penta (groepsdynamiek), tijdsgevoeligheid. Diepst HD-dekking onder commerciële API’s.

Beveiliging en privacy

Worden verzoekgegevens opgeslagen?

API werkt stateless - gegevens over datum/tijd/geboortecoördinaten worden niet opgeslagen na verwerking van het verzoek. Alleen metadata worden gelogd: key_id, endpoint, timestamp, latency, credits. Geen persoonlijke gegevens.

Voldoet de API aan GDPR-eisen?

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

Zijn AI-interpretaties veilig?

AI endpoints (/interpret/*, /horoscope/*) hebben ingebouwde safety guardrails: verbod op medische, juridische, financiële adviezen. Elk antwoord bevat een disclaimer. Volledige audit trail - voor enterprise compliance.

Ondersteuning

Hoe kan ik hulp krijgen?

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 - toegewezen manager in Slack. Contactgegevens - op de pagina Contact.

Is er een SLA?

Indie: 99% uptime. Starter en Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: op maat gemaakte SLA met financiële garanties.

Vergelijkbare namen

Is AstroWay API (astroway.info) verbonden met het ‘Astroway’ abonnement van astroway.life?

Nee. astroway.info en api.astroway.info zijn een aparte, onafhankelijke bedrijf. Wij bieden een astrologische API voor ontwikkelaars (api.astroway.info), een app voor eindgebruikers (app.astroway.info) en astrologische consulten. Wij hebben geen enkele relatie met het consumentenastrologie abonnement dat wordt geadverteerd en afgeschreven onder de naam ‘Astroway’ via astroway.life (e-mails van no-reply@astroway.life, persoon ‘Celeste’, op bankafschriften - ‘Astroway’). De operator van dit abonnement is TrafficLeader OÜ (Estland, ook traffic-leader.com); de bijbehorende biller SKYREAD.PRO is ABCMobile OÜ (Estland). Alleen de gelijkende naam - dit zijn verschillende bedrijven.

Mijn rekening wordt belast door ‘Astroway’ - hoe annuleer ik het abonnement en krijg ik geld terug?

Als je wordt afgeschreven voor het ‘Astroway’ abonnement (e-mails van no-reply@astroway.life, op bankafschriften - ‘Astroway’), is dit een ander bedrijf, astroway.life, niet wij. Wij hebben geen toegang tot je account of betalingen in deze service, dus kunnen we deze niet annuleren of geld teruggeven. Wat te doen:

1. Reageer direct op de e-mail van no-reply@astroway.life en gebruik de “afmelden / annuleren” link in de footer.
2. Als ze niet reageren: neem contact op met je bank of kaartuitgever (betaling op afschrift - ‘Astroway’; merchant - TrafficLeader OÜ of ABCMobile OÜ / SKYREAD.PRO, Estland) en vraag om herhaalde afschrijvingen te blokkeren of een terugbetaling (chargeback) te regelen.