Ú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ů:

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í. 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.

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

Nedaleko: /llms.txt jako vstupní bod a /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é), /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ň.