# Úkoly pro agenta

Tato stránka je napsána na základě logů za 30 dní, ne z fantazie. Následují volání, která skutečně provádějí integrátoři s klíčem, seřazená podle frekvence.

## Co se volá nejčastěji

| Endpoint | Počet úspěšných volání za 30 dní | K čemu |
|---|---|---|
| `POST /v1/human-design` | 12 563 | bodygraph: typ, profil, autorita, kanály |
| `POST /v1/chart` | 11 763 | natalní horoskop: planety, domy, aspekty |
| `POST /v1/transits` | 1 999 | transity do natalu na datum |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | védické období Vimshottari |
| `POST /v1/houses` | 861 | pouze cuspy a úhly, bez planet |
| `POST /v1/planets` | 761 | pouze pozice těles |
| `POST /v1/acg` | 704 | astrokarta, linie po světě |
| `POST /v1/transit-calendar` | 678 | kalendář transity na období |
| `POST /v1/horoscope/daily` | 549 | text na den (AI) |
| `POST /v1/synastry` | 437 | kompatibilita dvou horoskopů |

`GET /v1/auth/keys/me` (262) je v tomto seznamu: agenti kontrolují klíč před prací. Je to zdarma a nevyužívá kredity.

## Minimální volání

Jedno tělo stačí pro `chart`, `houses`, `planets`, `human-design`, `transits` a zbytek endpointů:

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

Přesná pravidla polí: [Formáty polí](/agent-setup/field-formats/). Klíč `aw_test_*` nevyužívá kredity, takže je vhodný pro vývoj.

## Číst specifikaci, ne hádat

Každá stránka operace má **markdownový dvojník**: stejný URL plus `.md`. To je to, co byste měli modelu dávat místo HTML.

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

Nedaleko: [`/llms.txt`](https://api.astroway.info/llms.txt) jako vstupní bod a [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) jako kompletní specifikace.

## Kdy klíč není potřeba

Bez klíče fungují tři jmenné prostory, všechny s limitem na IP: `/v1/public/*` (devět výpočetných endpointů, uvedených na stránce [Bezplatné](/free/)), `/v1/embed/*` (hotová widgety) a `/v1/reference/*` (referenční materiály: znamení, planety, aspekty).

Odpověď bez klíče obsahuje dodatečné pole `_footer` s podpisem, což je normální, tak se označuje bezplatná úroveň.

## Další

- [Typické chyby](/agent-setup/mistakes/): co nejčastěji vrací 4xx
- [Pasti](/agent-setup/gotchas/): chování, které překvapuje
- [MCP](/agent-setup/): jeden katalog nástrojů pro Claude, Cursor a zbytek