API horoskopu natalnego
Zamień jeden moment narodzin w kompletny, ustrukturyzowany horoskop natalny — planety, wierzchołki domów, aspekty i dane kątowe — w jednym żądaniu POST. Zodiak tropikalny, trzynaście systemów domów, precyzja Swiss Ephemeris, wynik w JSON.
API horoskopu natalnego
Endpoint natal-chart przelicza datę urodzenia, godzinę zegarową i przesunięcie UTC na precyzyjny dzień juliański, a następnie odpytuje silnik Swiss Ephemeris o długość geocentryczną, szerokość i prędkość każdego ciała — dziesięć klasycznych planet wraz z węzłami księżycowymi, Chironem i Czarnym Księżycem Lilith. Wyznacza Ascendent i Medium Coeli na podstawie szerokości i długości geograficznej miejsca urodzenia, dzieli domy według wybranego systemu, przypisuje każdą planetę do jej znaku i domu oraz oblicza pełną siatkę aspektów ze znacznikami aplikacji/separacji i dokładnymi orbami. Ruch wsteczny jest oznaczany na podstawie prędkości ciała, a sekta horoskopu (narodziny dzienne lub nocne) jest zwracana, aby dalsza interpretacja mogła poprawnie ważyć dobroczyńców i złoczyńców.
POST/v1/chart
curl -X POST https://api.astroway.info/v1/chart \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"houseSystem": "P"
}'{
"ok": true,
"data": {
"planets": [
{ "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
{ "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
],
"houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
"aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
}
}Parametry
| name | type | Wymagane | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | tak | Birth date. |
| time | string (HH:MM:SS) | tak | Local clock time at birth. |
| timezoneOffset | number (hours) | tak | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | tak | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | tak | Birth-place longitude, decimal degrees (east positive). |
| houseSystem | string | nie | One-letter Swiss Ephemeris code — P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
Kiedy używać
Sięgnij po ten endpoint zawsze, gdy potrzebujesz strukturalnego szkieletu horoskopu: widżetu horoskopu natalnego, raportu natalnego, procesu onboardingu personalizującego treści według Słońca/Księżyca/Ascendentu lub agenta AI, który potrzebuje surowych pozycji, zanim cokolwiek zinterpretuje. To wymagane wywołanie wstępne dla synastrii, tranzytów, progresji i większości typów raportów — oblicz horoskop raz, zapisz JSON w pamięci podręcznej i przekazuj go do cięższych endpointów zamiast przeliczać za każdym razem. Ponieważ odpowiedź to czyste dane (bez tekstu, bez obrazów), wpasowuje się czysto w dowolny stack: wyrenderuj ją samodzielnie, przekaż do LLM albo przekaż jednemu z naszych endpointów renderujących SVG.
Uwagi
Wartości domyślne podążają za głównonurtową konwencją zachodnią: zodiak tropikalny, domy Placidusa, „Wielka Trójka” Słońce–Księżyc–Ascendent. Silnikiem jest Swiss Ephemeris (Astrodienst) skompilowany do WASM i współdzielony z kalkulatorem działającym w przeglądarce, więc serwer i klient zgadzają się co do sekundy łukowej. Powyżej koła podbiegunowego, gdzie Placidus jest nieokreślony, domy przechodzą awaryjnie na Porfiriusza.
Wypróbuj API Horoskop natalny
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.