API mahadaszy Vimshottari
Vimshottari to 120-letni cykl okresów planetarnych, który kotwiczy timing wedyjski. Ten endpoint odczytuje pozycję syderycznego Księżyca w chwili urodzenia, lokalizuje zajmowaną przez niego nakszatrę i z tego jednego punktu rozwija uporządkowany łańcuch mahadasz — głównych okresów życia, z których każdy rządzony jest przez jedną z dziewięciu grah — wraz z dokładnymi datami kalendarzowymi, które je ograniczają.
API mahadaszy Vimshottari
Endpoint przelicza datę urodzenia, godzinę zegarową i przesunięcie UTC na dzień juliański, a następnie odpytuje Swiss Ephemeris o długość geocentryczną Księżyca i stosuje ayanamsę Lahiri, aby przesunąć ją z zodiaku tropikalnego do syderycznego. Ta długość syderyczna ustala natalną nakszatrę oraz frakcję już w niej upłynioną, co określa, ile z okresu pierwszej rządzącej planety pozostaje w chwili urodzenia. Stąd rozkłada pełną 120-letnią sekwencję Vimshottari w porządku kanonicznym — Ketu, Wenus, Słońce, Księżyc, Mars, Rahu, Jowisz, Saturn, Merkury — z każdą mahadaszą niosącą przydzielony jej okres oraz konkretne daty początku i końca. Odpowiedź zwraca także natalną nakszatrę, długość syderyczną Księżyca oraz użytą wartość ayanamsy, więc oś czasu jest w pełni audytowalna.
POST/v1/vedic/dashas/vimshottari/maha
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
-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
}'{
"ok": true,
"data": {
"system": "vimshottari",
"level": "maha",
"ayanamsa": 23.85,
"moonSiderealLongitude": 258.97,
"nakshatra": "Purva Ashadha",
"periods": [
{
"lord": "Venus",
"start": "1986-02-11",
"end": "2006-02-11"
},
{
"lord": "Sun",
"start": "2006-02-11",
"end": "2012-02-11"
}
]
}
}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). |
Kiedy używać
Użyj tego endpointu, gdy potrzebujesz szkieletu dasz najwyższego poziomu — makrookresów ramujących rozdziały życia osoby — a nie szczegółów na poziomie dnia. To naturalne pierwsze wywołanie dla osi czasu predykcyjnej: wyrenderuj sekwencję głównych okresów, podświetl, który jest obecnie aktywny dla danej daty, i pozwól użytkownikom drążyć dalej. Ponieważ cały łańcuch wynika deterministycznie z jednej pozycji Księżyca, możesz obliczyć go raz przy rejestracji i buforować bezterminowo. Gdy potrzebujesz zagnieżdżonych podokresów wewnątrz danej mahadaszy, rozgałęź do dedykowanych endpointów antardasha, pratyantar, sookshma i prana w obrębie tej samej rodziny Vimshottari.
Uwagi
Ta trasa zwraca wyłącznie warstwę mahadaszy (głównego okresu). Drobniejsze podziały — antardasha, pratyantar, sookshma i prana — mieszkają na osobnych endpointach pod /v1/vedic/dashas/vimshottari/*. Obliczenie podąża za tradycją Parashary skodyfikowaną w Bṛhat Parāśara Horā Śāstra, z zodiakiem syderycznym i ayanamsą Lahiri jako domyślnym układem odniesienia.
Wypróbuj API Mahadasza Vimshottari
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.