De catalogus van AstroWay telt inmiddels 865 endpoints in 57 groepen. Op die schaal is de hoofdvraag van een integrator niet “is de dekking voldoende”, maar “hoe raak ik niet de weg kwijt”. Dit artikel is een kaart: hoe de catalogus in domeinen is verdeeld en hoe je binnen een minuut vindt wat je zoekt.
Eén patroon voor alle aanroepen
Section titled “Eén patroon voor alle aanroepen”Ongeacht het domein heeft elk rekenendpoint dezelfde vorm:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonDe body is JSON met geboortegegevens (datum, tijd, coördinaten) of met parameters die specifiek zijn voor de techniek. Het antwoord is altijd { "ok": true, "data": {...} } of { "ok": false, "error": {...} }. Geen GraphQL, geen aparte auth-flows per domein: één sleutel in de header X-Api-Key, één antwoordformaat.
Dat betekent dat de wrapper die je voor de geboortehoroscoop schrijft ook werkt voor BaZi en voor runen: alleen het pad en het schema van de body veranderen.
Domeinen van de catalogus
Section titled “Domeinen van de catalogus”De catalogus is gegroepeerd in grote domeinen. Hier is de kaart met echte aantallen (de getallen komen bij elke build uit het manifest, dus ze zijn hier altijd actueel):
| Domein | Endpoints | Wat erin zit |
|---|---|---|
| Westerse astrologie | 186 | Geboortehoroscoop, aspecten, waardigheden, prognostiek (transits, progressies, directies), horary, 4 hellenistische scholen, moderne psychologische, evolutionaire astrologie, kosmobiologie |
| Vedisch | 230 | Het grootste domein: nakshatras, dasha’s, divisionele horoscopen (varga), yoga’s, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Bodygraph, kanalen, poorten, type/profiel/autoriteit, incarnatiekruis |
| Tarot | 71 | Drie decks: Rider-Waite-Smith, Marseille, Lenormand, met leggingen, betekenissen en combinaties |
| Numerologie | 55 | 5 systemen met elk 10 berekeningen (pythagoreïsch, Chaldeeuws, twee kabbalistische, Vedisch) |
| Chinees + Maya | 55 | BaZi (vier pilaren), Zi Wei Dou Shu, Chinese dierenriem en feng shui, Mayakalenders |
| Waarzeggerij | 40 | Geomantie (Agrippa), runen van de Oudere Futhark, handlezen (Cheiro), I Ching |
| Toegepaste niches | 53 | Wellness, astrologie voor huisdieren, business, financiën, gezin |
| Rapporten | 29 | Kant-en-klare interpretaties (natal, synastry), in HTML/PDF, met white-label branding |
| Rendering | 14 | SVG/PNG-horoscoopwielen, bodygraph, transitringen, zonder eigen frontend |
| Dev-tools | 47 | Webhooks, realtime streaming, insluitbare widgets, white-label |
De rest: AI-interpretaties, horoscopen, referentie-endpoints (tekens, planeten, aspecten) en systeemendpoints (health, usage, openapi).
Vedisch is een verhaal apart
Section titled “Vedisch is een verhaal apart”230 Vedische endpoints, dat is meer dan het hele westerse deel. De reden is eenvoudig: de Vedische traditie is sterker geformaliseerd. Waar de westerse astrologie één set huizen heeft, heeft de Vedische 16 divisionele horoscopen (varga), meerdere dasha-systemen en tientallen yoga’s met duidelijke regels. Elk daarvan is een apart endpoint met een deterministisch resultaat.
Bouw je voor de Indiase markt, dan is dit de kern van je product, geen extraatje.
Nauwkeurigheid onder dit alles
Section titled “Nauwkeurigheid onder dit alles”Hoe exotisch de techniek ook is, planeetposities worden berekend door één kern op basis van Swiss Ephemeris. Diezelfde kern draait zowel in onze app als in de API: één codebase, geen enkele afwijking. De rekenendpoints worden gedekt door 888 snapshottests, die bij elke PR worden vergeleken met referentiebronnen. Meer daarover in een apart artikel over nauwkeurigheid in CI.
Zo vind je wat je nodig hebt
Section titled “Zo vind je wat je nodig hebt”Drie routes, de snelste eerst:
- OpenAPI-referentie: /docs/api/ wordt rechtstreeks gegenereerd uit de productiespecificatie
openapi.json. De groepen in de zijbalk = de domeinen hierboven. Elk endpoint heeft een body-schema, een voorbeeld en een knop “proberen”. - MCP-catalogus: werk je in Claude of Cursor, dan is de hele catalogus beschikbaar als set tools via
mcp.astroway.info. De agent vindt zelf het juiste endpoint aan de hand van de beschrijving. - Zoeken in de specificatie:
curl https://api.astroway.info/v1/openapi.jsonlevert het volledige machineleesbare contract. Handig om je eigen client te genereren.
Aan de slag
Section titled “Aan de slag”Een sleutel via dashboard/sign-up geeft je 10 000 credits per maand, genoeg om tientallen domeinen door te lopen en te zien wat voor jou relevant is. Je hoeft de catalogus niet in zijn geheel te bestuderen: neem je eigen domein, de rest wacht wel tot je het nodig hebt.
Posities tot op de boogseconde in 4 regels code.
Gratis sleutel zonder kaart. 5.000 calls per maand tot de eerste betaling.