# Zadania dla agenta

Ta strona jest napisana na podstawie logów sprzedaży z ostatnich 30 dni, a nie z wyobraźni. Poniżej znajdują się te wywołania, które faktycznie wykonują integratorzy z kluczem, w kolejności częstotliwości.

## Co jest najczęściej wywoływane

| Endpoint | Liczba pomyślnych wywołań w ciągu 30 dni | Do czego służy |
|---|---|---|
| `POST /v1/human-design` | 12 563 | bodygraph: typ, profil, autorytet, kanały |
| `POST /v1/chart` | 11 763 | mapa urodzeniowa: planety, domy, aspekty |
| `POST /v1/transits` | 1 999 | transyty do natywnego w określonej dacie |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | wedyjskie okresy Vimshottari |
| `POST /v1/houses` | 861 | tylko kuspy i kąty, bez planet |
| `POST /v1/planets` | 761 | tylko pozycje ciał niebieskich |
| `POST /v1/acg` | 704 | astrokartaografia, linie na świecie |
| `POST /v1/transit-calendar` | 678 | kalendarz transytów dla okresu |
| `POST /v1/horoscope/daily` | 549 | tekst na dzień (AI) |
| `POST /v1/synastry` | 437 | kompatybilność dwóch map |

`GET /v1/auth/keys/me` (262) jest również na tej liście: agenci sprawdzają klucz przed pracą. Jest to darmowe i nie zużywa kredytów.

## Minimalne wywołanie

Jeden obiekt nadaje się do `chart`, `houses`, `planets`, `human-design`, `transits` i pozostałych endpointów kartowych:

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

Dokładne reguły pól: [Formaty pól](/agent-setup/field-formats/). Klucz `aw_test_*` nie zużywa kredytów, więc warto go używać do rozwoju.

## Czytać specyfikację, a nie zgadywać

Każda strona operacji ma **markdown-dwójnika**: ten sam URL plus `.md`. To to, co warto podawać modelowi zamiast HTML.

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

Obok: [`/llms.txt`](https://api.astroway.info/llms.txt) jako punkt wejścia i [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) jako pełna specyfikacja.

## Kiedy klucz nie jest potrzebny

Bez klucza działają trzy przestrzenie nazw, wszystkie z limitem na IP: `/v1/public/*` (dziewięć endpointów obliczeniowych, wymienionych na stronie [Darmowe](/free/)), `/v1/embed/*` (gotowe widżety) i `/v1/reference/*` (poradniki: znaki, planety, aspekty).

Odpowiedź bez klucza zawiera dodatkowe pole `_footer` z podpisem, i to jest normalne, tak oznaczony jest darmowy poziom.

## Dalej

- [Typowe błędy](/agent-setup/mistakes/): to, co najczęściej zwraca 4xx
- [Pułapki](/agent-setup/gotchas/): zachowanie, które zaskakuje
- [MCP](/agent-setup/): jeden katalog narzędzi dla Claude, Cursor i reszty