Задачі для агента

Ця сторінка написана з логів прода за 30 днів, а не з уяви. Нижче ті виклики, які справді роблять інтегратори з ключем, у порядку частоти.

Що викликають найчастіше

Ендпоінт	Успішних викликів за 30 днів	Навіщо
`POST /v1/human-design`	12 563	бодиграф: тип, профіль, авторитет, канали
`POST /v1/chart`	11 763	натальна карта: планети, доми, аспекти
`POST /v1/transits`	1 999	транзити до наталу на дату
`POST /v1/vedic/dashas/vimshottari/maha`	1 272	ведичні періоди Вімшоттарі
`POST /v1/houses`	861	лише куспіди й кути, без планет
`POST /v1/planets`	761	лише позиції тіл
`POST /v1/acg`	704	астрокартографія, лінії по світу
`POST /v1/transit-calendar`	678	календар транзитів на період
`POST /v1/horoscope/daily`	549	текст на день (AI)
`POST /v1/synastry`	437	сумісність двох карт

GET /v1/auth/keys/me (262) у цьому ж списку: агенти перевіряють ключ перед роботою. Це безкоштовно і кредитів не витрачає.

Мінімальний виклик

Одне тіло підходить до chart, houses, planets, human-design, transits і решти карткових ендпоінтів:

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

Точні правила полів: Формати полів. Ключ aw_test_* не витрачає кредитів, тому ним і варто розробляти.

Читати специфікацію, а не вгадувати

Кожна сторінка операції має markdown-двійника: той самий URL плюс .md. Це те, що варто давати моделі замість HTML.

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

Поруч: /llms.txt як точка входу і /v1/openapi.json як повна специфікація.

Коли ключ не потрібен

Без ключа працюють три простори імен, усі з лімітом за IP: /v1/public/* (дев’ять розрахункових ендпоінтів, перелічені на сторінці Безкоштовні), /v1/embed/* (готові віджети) і /v1/reference/* (довідники: знаки, планети, аспекти).

Відповідь без ключа несе додаткове поле _footer з підписом, і це нормально, так позначається безкоштовний рівень.