Taken voor agent

Deze pagina is geschreven op basis van logs van de afgelopen 30 dagen, niet uit verbeelding. Hieronder staan de aanroepen die integrators daadwerkelijk met een sleutel doen, in volgorde van frequentie.

Meest vaak aangeroepen endpoints

Endpoint	Succesvolle aanroepen in 30 dagen	Waarvoor
POST /v1/human-design	12 563	bodygraph: type, profiel, autoriteit, kanalen
POST /v1/chart	11 763	geboortekaart: planeten, huizen, aspecten
POST /v1/transits	1 999	transits naar geboortekaart op datum
POST /v1/vedic/dashas/vimshottari/maha	1 272	vedische Vimshottari periodes
POST /v1/houses	861	alleen huizenhoeken, zonder planeten
POST /v1/planets	761	alleen posities van lichamen
POST /v1/acg	704	astrocartografie, lijnen over de wereld
POST /v1/transit-calendar	678	transits kalender voor periode
POST /v1/horoscope/daily	549	dagtekst (AI)
POST /v1/synastry	437	compatibiliteit van twee kaarten

GET /v1/auth/keys/me (262) staat ook in deze lijst: agents controleren de sleutel voordat ze werken. Dit is gratis en kost geen credits.

Minimale aanroep

Eén lichaam werkt voor chart, houses, planets, human-design, transits en andere kaart-gerelateerde endpoints:

terminal

curl -X POST https://api.astroway.info/v1/chart \
-H "X-Api-Key: aw_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-05-15","time":"15:30:00","timezone":"Europe/Kyiv","latitude":50.45,"longitude":30.52}'

De exacte veldregels: Veldformaten. De sleutel aw_test_* kost geen credits, dus die moet je gebruiken voor ontwikkeling.

Lees de specificatie, gok niet

Elke operatiepagina heeft een markdown-twin: dezelfde URL plus .md. Dit is wat je aan een model moet geven in plaats van HTML.

terminal

curl https://api.astroway.info/docs/api/operations/acg_categories_get.md

Erbij: /llms.txt als startpunt en /v1/openapi.json als volledige specificatie.

Wanneer een sleutel niet nodig is

Zonder sleutel werken drie namespaces, allemaal met een IP-limiet: /v1/public/* (negen rekenendpoints, vermeld op de Gratis pagina), /v1/embed/* (klaar voor gebruik widgets) en /v1/reference/* (referenties: tekens, planeten, aspecten).

Een antwoord zonder sleutel bevat een extra veld _footer met een handtekening, en dat is normaal, zo wordt het gratis niveau aangeduid.

Volgende

• Typische fouten: wat vaak 4xx retourneert
• Valkuilen: gedrag dat verrassend is
• MCP: één catalogus met tools voor Claude, Cursor en de rest