API powrotu Księżyca
Znajdź następny moment, gdy Księżyc wraca do swojej natalnej długości w dniu wybranej daty lub po niej — mniej więcej co 27,3 dnia — i postaw dla niego horoskop w wybranym przez ciebie miejscu. Przekaż dane natalne i datę początkową, otrzymaj horoskop powrotu Księżyca. Precyzja Swiss Ephemeris, wynik w JSON.
API powrotu Księżyca
Endpoint lunar-return odczytuje dokładną długość natalnego Księżyca z dostarczonych danych urodzeniowych, a następnie przeszukuje do przodu od podanej daty początkowej w poszukiwaniu pierwszego momentu, gdy tranzytujący Księżyc wraca do tej samej długości. Ponieważ Księżyc kończy cykl syderyczny w około 27,3 dnia, ten powrót przypada mniej więcej co miesiąc. Endpoint przelicza dopasowany moment na dzień juliański, pobiera pozycje geocentryczne i prędkości z silnika Swiss Ephemeris i stawia dla niego pełny horoskop — planety powrotu ze znakami i pozycjami w domach, wierzchołki domów oraz kompletną siatkę aspektów ze znacznikami aplikacji i separacji oraz dokładnymi orbami. Domyślnie horoskop stawiany jest dla miejsca natalnego, ale możesz podać inną szerokość i długość geograficzną, aby relokować powrót, co przekształca kąty i domy, zachowując ten sam moment powrotu. Wynik odczytuje się jako mapę emocjonalnych i rytmicznych tematów na nadchodzący miesiąc księżycowy.
POST/v1/lunar-return
curl -X POST https://api.astroway.info/v1/lunar-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,
"afterDate": "2026-06-15"
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Moon",
"longitude": 282.7,
"sign": "Capricorn",
"house": 6
}
],
"houses": {
"ascendant": 201.5,
"mc": 110.3,
"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). |
| afterDate | string (YYYY-MM-DD) | tak | Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it. |
| afterTime | string (HH:MM:SS) | nie | Optional clock time of the start point (HH:MM:SS). |
| afterTzOffset | number (hours) | nie | Optional UTC offset for the start point, in hours. |
| locationLat | number | nie | Optional latitude in decimal degrees to relocate the return chart, north positive. |
| locationLng | number | nie | Optional longitude in decimal degrees to relocate the return chart, east positive. |
Kiedy używać
Użyj powrotu Księżyca do prognozowania krótkocyklicznego, mniej więcej miesięcznego — funkcji „miesiąc księżycowy przed tobą”, narzędzia śledzącego rytm emocjonalny lub bardziej drobiazgowego towarzysza rocznego powrotu Słońca. Tam gdzie powrót Słońca ramuje cały rok, powrót Księżyca ramuje najbliższe cztery tygodnie, co czyni go dobrze dopasowanym do cyklicznych raportów miesięcznych oraz cykli nawyków lub nastrojów. Przekaż datę początkową jako punkt, po którym chcesz następnego powrotu — często dzisiaj lub datę ostatniego powrotu — a endpoint przejdzie do przodu do najbliższego. Opcjonalne nadpisanie lokalizacji pozwala postawić powrót dla miejsca, w którym osoba faktycznie jest w danym miesiącu, a nie dla jej miejsca urodzenia, co ma znaczenie dla wrażliwych na kąty domów. Połącz kolejne wywołania w łańcuch, aby zbudować przesuwającą się sekwencję horoskopów miesięcznych.
Uwagi
Endpoint zwraca następny pojedynczy powrót w dniu podanej daty lub po niej, a nie serię — wywołuj wielokrotnie, przesuwając datę początkową, aby zbudować sekwencję. Wartość ~27,3 dnia to miesiąc syderyczny, więc powroty dryfują względem kalendarza. Jeśli nie podano lokalizacji, horoskop stawiany jest w miejscu natalnym; nadpisanie relokuje wyłącznie kąty i domy. W całości zodiak tropikalny i Swiss Ephemeris.
Wypróbuj API Powrót Księżyca
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.