API tranzytów
Uchwyć stan nieba w dowolnej dacie docelowej i nałóż go na strukturę domów natalnych osoby w jednym żądaniu POST. Planety tranzytujące, wierzchołki natalne, w które wpadają, siatka aspektów wśród ciał tranzytujących, a do tego paralele i antyscje — precyzja Swiss Ephemeris, wynik w JSON.
API tranzytów
Endpoint tranzytów przyjmuje dane natalne osoby — datę urodzenia, godzinę, przesunięcie UTC, szerokość, długość geograficzną i system domów — oraz osobny moment docelowy. Przelicza tę datę docelową i godzinę zegarową na dzień juliański, odpytuje silnik Swiss Ephemeris o długość geocentryczną, szerokość i prędkość każdego ciała tranzytującego, a następnie rzutuje te pozycje na domy wyznaczone z lokalizacji natalnej. Odpowiedź zawiera planety tranzytujące wraz z ich znakami i pozycjami w domach, wierzchołki domów natalnych oraz pełną siatkę aspektów obliczoną wśród samych ciał tranzytujących, każdy ze znacznikami aplikacji lub separacji i dokładnymi orbami. Zwraca także aspekty paralelne i antyscje (punkty lustrzane) dla pracy z deklinacją i osią przesileniową. Ruch wsteczny jest oznaczany na podstawie prędkości ciała, więc widzisz, które tranzyty są direct, stacjonarne lub poruszają się wstecz w żądanym momencie.
POST/v1/transits
curl -X POST https://api.astroway.info/v1/transits \
-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,
"transitDate": "2026-06-15",
"transitTime": "12:00:00",
"transitTzOffset": 3
}'{
"ok": true,
"data": {
"input": {},
"julianDay": 2461206.875,
"planets": [
{
"name": "Sun",
"longitude": 84.29,
"sign": "Gemini",
"house": 11
}
],
"houses": {
"ascendant": 160.4,
"mc": 70.1,
"cusps": [
"…"
]
},
"aspects": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "conjunction",
"orb": 1.2,
"applying": true
}
],
"parallelAspects": [
"…"
],
"antiscia": [
"…"
]
}
}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). |
| transitDate | string (YYYY-MM-DD) | tak | Required target date for the transit snapshot (YYYY-MM-DD). |
| transitTime | string (HH:MM:SS) | nie | Optional clock time of the transit moment (HH:MM:SS). |
| transitTzOffset | number (hours) | nie | Optional UTC offset for the transit moment, in hours. |
Kiedy używać
Użyj tego, gdy chcesz uzyskać całe niebo, tak jak rozkłada się nad horoskopem osoby w danym dniu — widżet codziennych tranzytów, panel „co jest teraz na niebie” w stylu prognozy pogody, lub surową strukturę, którą agent AI odczytuje przed opisaniem bieżącego klimatu astrologicznego. Ponieważ zwraca horoskop tranzytowy nad strukturą domów natalnych, a nie wyselekcjonowaną listę kontaktów tranzyt–natal, to właściwe wywołanie, gdy potrzebujesz samego strukturalnego ujęcia chwili. Jeśli natomiast chcesz uzyskać datowane kontakty tranzyt–natal przeskanowane w zakresie dat — dokładne daty, ingresy, punkty stacjonarne — sięgnij po endpoint /transit-calendar, który jest stworzony do takiego zadania timingowego. Połącz oba: ten endpoint dla horoskopu-chwili, a kalendarz dla listy nadchodzących wydarzeń.
Uwagi
Bądź precyzyjny co do zakresu: zwraca to horoskop tranzytowy nałożony na strukturę domów natalnych, a nie wstępnie przefiltrowaną listę aspektów tranzyt–natal. Siatka aspektów jest obliczana wśród ciał tranzytujących, a nie między punktami tranzytowymi a natalnymi. Dla timingu do natalu w zakresie dat użyj /transit-calendar. Domy podążają za wybranym systemem natalnym; w całości zodiak tropikalny i Swiss Ephemeris.
Wypróbuj API Horoskop tranzytowy
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.