Cataloguskaart: hoe 700+ endpoints van AstroWay zijn gestructureerd

De AstroWay-catalogus bevat 758 endpoints in 57 domeinen. Op deze schaal is het hoofdprobleem van de integrator niet “heeft de dekking genoeg”, maar “hoe om je niet te verliezen”. Dit artikel is een kaart: hoe de catalogus is opgedeeld in domeinen en hoe je het juiste kunt vinden in een minuut.

Ongeacht de domein, elk berekeningseindpunt heeft dezelfde vorm:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

Het lichaam is een JSON met gegevens over de geboorte (datum, tijd, coördinaten) of specifieke technische parameters. De reactie is altijd { "ok": true, "data": {...} } of { "ok": false, "error": {...} }. Geen GraphQL, geen aparte auth-flow voor domeinen: één sleutel in de header X-Api-Key, één formaat voor de reactie.

Dit betekent dat de omhulling die je schrijft onder de kaart ook geschikt is voor BaZi en runes - verandert alleen de weg en de schema van het lichaam.

De catalogus is ingedeeld in grote domeinen. Hier is een kaart met reële tellers (aantal genomen uit de manifest van elke build, dus altijd actueel):

Overige - AI-interpretaties, horoscopen, informatieve eindpunten (tekenen, planeten, aspecten) en systeemgegevens (gezondheid, gebruik, OpenAPI).

174 Vedic-eindpunten - meer dan de hele westerse helft. Reden eenvoudig: de Vedic-traditie is formaliser. Daar waar westerse astrologie heeft één set huizen, Vedic heeft 16 divisional-kaarten (varga), meerdere dasha-systemen, tientallen yogas met duidelijke regels. Elk van dit alles - een apart eindpunt met een bepaalde uitkomst.

Als je bouwt voor de Indiase markt, is dit het kloppende hart van het product, niet een toevoeging.

Ongeacht de exotiek van de techniek, planetenposities worden berekend door één kernen op Swiss Ephemeris (WASM). Hetzelfde kernen werkt ook in de browser van onze applicatie en op de API-server - één codebasis, geen verschil. Berekeningseindpunten zijn 873 gesnapt-testen, die bij elke PR worden vergeleken met referenties van de bron. Meer over dit - in een aparte artikel over CI-accuraatheid.

Drie manieren, van het snelste:

1. OpenAPI-gids - /docs/api/ wordt gegenereerd rechtstreeks van de product-specificaatie openapi.json. Domeinen in de zijbalk = domeinen hierboven. Elk eindpunt heeft een schema van het lichaam, een voorbeeld en een knop “probeer het”.

2. MCP-catalogus - als je in Claude of Cursor bent, is de hele catalogus beschikbaar als een set hulpmiddelen via mcp.astroway.info. De agent vindt het juiste eindpunt zelfs op basis van de beschrijving.

3. Zoeken naar specificatie - curl https://api.astroway.info/v1/openapi.json geeft de volledige machine-leesbare contract. Handig voor codegeneratie van een eigen client.

De sleutel op dashboard/sign-up geeft 10.000 credits per maand - genoeg om door de decennia van domeinen te lopen en te begrijpen wat dit is voor jou. De catalogus hoeft niet helemaal te worden bestudeerd: neem je domein, en de rest wacht tot het nodig is.