# 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:

<Code lang="bash" title="terminal" code={`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](/agent-setup/field-formats/). 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.

<Code lang="bash" title="terminal" code={`curl https://api.astroway.info/docs/api/operations/acg_categories_get.md`} />

Erbij: [`/llms.txt`](https://api.astroway.info/llms.txt) als startpunt en [`/v1/openapi.json`](https://api.astroway.info/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](/free/) 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](/agent-setup/mistakes/): wat vaak 4xx retourneert
- [Valkuilen](/agent-setup/gotchas/): gedrag dat verrassend is
- [MCP](/agent-setup/): één catalogus met tools voor Claude, Cursor en de rest