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

Ця сторінка написана з логів прода за 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` і решти карткових ендпоінтів:

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

Точні правила полів: [Формати полів](/agent-setup/field-formats/). Ключ `aw_test_*` не витрачає кредитів, тому ним і варто розробляти.

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

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

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

Поруч: [`/llms.txt`](https://api.astroway.info/llms.txt) як точка входу і [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) як повна специфікація.

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

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

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

## Далі

- [Типові помилки](/agent-setup/mistakes/): що частіше за все повертає 4xx
- [Підводні камені](/agent-setup/gotchas/): поведінка, яка дивує
- [MCP](/agent-setup/): один каталог інструментів для Claude, Cursor і решти