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:

terminal

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

terminal

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

Lângă: /llms.txt ca punct de intrare și /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), /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: ceea ce returnează cel mai des 4xx
• Capcane: comportamentul care surprinde
• MCP: un catalog de unelte pentru Claude, Cursor și restul