API powrotu Słońca
Postaw horoskop na dokładny moment, gdy Słońce wraca do swojego natalnego stopnia w wybranym roku — astrologiczne urodziny. Przekaż horoskop natalny i rok, otrzymaj horoskop powrotu Słońca dla tego cyklu. Tropikalnie, Słońce do natalnego Słońca, precyzja Swiss Ephemeris, wynik w JSON.
API powrotu Słońca
Endpoint solar-return najpierw odczytuje dokładną długość zodiakalną natalnego Słońca z dostarczonych danych urodzeniowych, a następnie przeszukuje podany rok w poszukiwaniu precyzyjnego momentu, gdy tranzytujące Słońce wraca do tej samej długości — zwykle w granicach jednego dnia od kalendarzowych urodzin. Przelicza ten moment powrotu na dzień juliański, pobiera pozycje geocentryczne i prędkości z silnika Swiss Ephemeris i stawia dla niego pełny horoskop: planety powrotu wraz ze znakami i pozycjami w domach, wierzchołki domów oraz kompletną siatkę aspektów ze znacznikami aplikacji i separacji oraz dokładnymi orbami. Dopasowanie jest tropikalne i Słońce do natalnego Słońca, domyślnie nieskorygowane o precesję, więc Słońce powrotu siedzi na tropikalnym stopniu natalnego Słońca. Powstały horoskop odczytuje się jako mapę dominujących tematów na rok biegnący od jednych urodzin do następnych.
POST/v1/solar-return
curl -X POST https://api.astroway.info/v1/solar-return \
-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,
"year": 2026
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Sun",
"longitude": 54.23,
"sign": "Taurus",
"house": 9
}
],
"houses": {
"ascendant": 188.2,
"mc": 95,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}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). |
| year | number | tak | Required integer year in which to find the Sun's return to its natal longitude. |
Kiedy używać
Użyj powrotu Słońca do prognozowania rocznego — raportu „rok przed tobą”, funkcji horoskopu urodzinowego lub przepływu AI, który buduje dwunastomiesięczną prognozę z jednego datowanego horoskopu. To koń roboczy przewidywania opartego na powrotach: kąty, dom, w który wpada Słońce powrotu, oraz najściślejsze aspekty odczytuje się jako główne tematy danego roku słonecznego. Połącz go z tranzytami i progresjami dla głębi, ale sam powrót Słońca daje czyste, samodzielne roczne ujęcie kluczowane do własnych urodzin osoby, a nie do kalendarza. Ponieważ przekazujesz tylko dane natalne plus rok, wpasowuje się zgrabnie w wyzwalacze rocznicowe i zaplanowane coroczne e-maile — przeliczaj co rok, aby przesuwać prognozę do przodu.
Uwagi
Powrót jest dopasowywany tropikalnie, Słońce do natalnego Słońca, i domyślnie nieskorygowany o precesję, więc odzwierciedla konwencjonalny zachodni powrót Słońca, a nie wariant skorygowany syderycznie. Stawiany jest dla podanej lokalizacji natalnej; relokowane powroty Słońca wymagałyby ponownego postawienia w innym miejscu. W całości zodiak tropikalny i Swiss Ephemeris.
Wypróbuj API Powrót Słońca
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.