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:

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

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

Obok: /llms.txt jako punkt wejścia i /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), /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.