# Sarcini pentru agent

Această pagină este scrisă pe baza jurnalelor de utilizare din 30 de zile, nu din imaginație. Mai jos sunt apelurile pe care integratorii le fac cu adevărat cu cheia, în ordinea frecvenței.

## Ce se apelează cel mai des

| Endpoint | Apeluri reușite în 30 de zile | Pentru ce |
|---|---|---|
| `POST /v1/human-design` | 12 563 | bodygraph: tip, profil, autoritate, canale |
| `POST /v1/chart` | 11 763 | horoscop natal: planete, case, aspecte |
| `POST /v1/transits` | 1 999 | tranzite la natal pentru o dată |
| `POST /v1/vedic/dashas/vimshottari/maha` | 1 272 | perioade vedice Vimshottari |
| `POST /v1/houses` | 861 | doar cuspizi și unghiuri, fără planete |
| `POST /v1/planets` | 761 | doar pozițiile corpurilor cerești |
| `POST /v1/acg` | 704 | astrocartografie, linii pe hartă |
| `POST /v1/transit-calendar` | 678 | calendar de tranzite pentru o perioadă |
| `POST /v1/horoscope/daily` | 549 | text pentru zi (AI) |
| `POST /v1/synastry` | 437 | compatibilitatea a două hărți |

`GET /v1/auth/keys/me` (262) este în același listă: agenții verifică cheia înainte de a lucra. Acest lucru este gratuit și nu consumă credite.

## Apel minim

Un singur corp cerește se potrivește cu `chart`, `houses`, `planets`, `human-design`, `transits` și restul endpoint-urilor:

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

Regulile exacte ale câmpurilor: [Formatele câmpurilor](/agent-setup/field-formats/). Cheia `aw_test_*` nu consumă credite, prin urmare este ideală pentru dezvoltare.

## Citiți specificațiile, nu ghiciți

Fiecare pagină de operație are un **dublă markdown**: același URL plus `.md`. Acesta este ceea ce ar trebui să oferiți modelului în loc de HTML.

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

Lângă: [`/llms.txt`](https://api.astroway.info/llms.txt) ca punct de intrare și [`/v1/openapi.json`](https://api.astroway.info/v1/openapi.json) ca specificație completă.

## Când cheia nu este necesară

Fără cheie funcționează trei namespace-uri, toate cu limită per IP: `/v1/public/*` (nouă endpoint-uri de calcul, enumerate pe pagina [Gratuit](/free/)), `/v1/embed/*` (widget-uri gata de utilizare) și `/v1/reference/*` (referințe: semne, planete, aspecte).

Răspunsul fără cheie conține un câmp suplimentar `_footer` cu o semnătură, și este normal, așa se marchează nivelul gratuit.

## Următorii pași

- [Erori tipice](/agent-setup/mistakes/): ceea ce returnează cel mai des 4xx
- [Capcane](/agent-setup/gotchas/): comportamentul care surprinde
- [MCP](/agent-setup/): un catalog de unelte pentru Claude, Cursor și restul