# Feladatok az ügynöknek

Ez az oldal 30 nap logjaiból készült, nem a képzeletből. Alább azok a hívások, amiket a kulccsal rendelkező integrátorok valóban végrehajtanak, gyakoriság szerint.

## Mit hívnak a leggyakrabban

| Endpoint | Sikeres hívások 30 nap alatt | Miért |
|---|---|---|
| `POST /v1/human-design` | 12 563 | bodigráf: típus, profil, autoritás, csatornák |
| `POST /v1/chart` | 11 763 | születési horoszkóp: bolygók, házak, aspektusok |
| `POST /v1/transits` | 1 999 | transzitok a születési horoszkóphoz egy dátumra |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | vedikus Vimshottari periódusok |
| `POST /v1/houses` | 861 | csak a csúcsok és szögek, bolygók nélkül |
| `POST /v1/planets` | 761 | csak a testek pozíciói |
| `POST /v1/acg` | 704 | asztrokartográfia, vonalak a világon |
| `POST /v1/transit-calendar` | 678 | transzit naptár egy időszakra |
| `POST /v1/horoscope/daily` | 549 | napi szöveg (AI) |
| `POST /v1/synastry` | 437 | két térkép kompatibilitása |

`GET /v1/auth/keys/me` (262) ebben a listában: az ügynökök ellenőrzik a kulcsot a munka előtt. Ez ingyenes és nem fogyaszt krediteket.

## Minimális hívás

Egy test megfelel a `chart`, `houses`, `planets`, `human-design`, `transits` és a többi kártya endpointhoz:

<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}'`} />

A mezők pontos szabályai: [Mezőformátumok](/agent-setup/field-formats/). Az `aw_test_*` kulcs nem fogyaszt krediteket, ezért érdemes ezzel fejleszteni.

## Olvasd a specifikációt, ne tippeld

Minden művelet oldalnak van **markdown-ikertest**: ugyanaz az URL plusz `.md`. Ezt érdemes a modellnek adni a HTML helyett.

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

Mellett: [`/llms.txt`](https://api.astroway.info/llms.txt) mint belépési pont és [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) mint teljes specifikáció.

## Amikor a kulcs nem szükséges

Kulcs nélkül három névtér működik, mind IP korláttal: `/v1/public/*` (kilenc számított endpoint, felsorolva a [Ingyenes](/free/) oldalon), `/v1/embed/*` (kész widgetek) és `/v1/reference/*` (referenciák: jelek, bolygók, aspektusok).

A kulcs nélküli válasz tartalmaz egy `_footer` mezőt aláírással, és ez normális, így jelölik az ingyenes szintet.

## Tovább

- [Gyakori hibák](/agent-setup/mistakes/): ami legtöbbször 4xx-et ad vissza
- [Csapdák](/agent-setup/gotchas/): meglepő viselkedés
- [MCP](/agent-setup/): egy eszközkatalógus Claude, Cursor és a többiek számára