AstroWay/api v2.95.1 · astrology-api
усі системи в нормі
// astrology api · POST /v1/vedic/dashas/vimshottari/maha

API періодів Вімшоттарі-даша

Вімшоттарі — це 120-річний цикл планетних періодів, на якому тримається ведична астрологія часу. Цей ендпоінт зчитує сидеричне положення Місяця на момент народження, визначає накшатру, в якій він перебуває, і з цієї єдиної точки розгортає впорядкований ланцюг махадаш — великих життєвих періодів, кожним з яких керує одна з дев'яти ґрах, — із точними календарними датами їхніх меж.

Ендпоінт
POST /v1/vedic/dashas/vimshottari/maha
Вартість
50 кредитів
Латентність
~62 ms
Тариф
Tier 3
// 01 / Що обчислює

API періодів Вімшоттарі-даша

Ендпоінт переводить дату народження, час за годинником і зсув UTC у юліанський день, потім запитує у Swiss Ephemeris геоцентричну довготу Місяця й застосовує аянамшу Lahiri, щоб зсунути її з тропічного зодіаку в сидеричний. Ця сидерична довгота фіксує натальну накшатру й частку, яка вже минула всередині неї, а та визначає, скільки періоду першої правлячої планети лишається на момент народження. Звідси він викладає повну 120-річну послідовність Вімшоттарі в канонічному порядку — Кету, Венера, Сонце, Місяць, Марс, Раху, Юпітер, Сатурн, Меркурій, — де кожна махадаша несе відведений їй проміжок і конкретні дати початку та кінця. У відповіді також повертаються натальна накшатра, сидерична довгота Місяця й використане значення аянамші, тож часову шкалу можна повністю перевірити.

// 02 / Живий запит

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"
      }
    ]
  }
}
// 03 / Параметри

Параметри

nametypeОбов’язк.
date string (YYYY-MM-DD) так Birth date.
time string (HH:MM:SS) так Local clock time at birth.
timezoneOffset number (hours) так UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number так Birth-place latitude, decimal degrees (north positive).
longitude number так Birth-place longitude, decimal degrees (east positive).
// 04 / Коли використовувати

Коли використовувати

Звертайтеся до цього ендпоінта, коли потрібен верхній рівень даш — макроперіоди, що окреслюють розділи життя людини, — а не деталізація до дня. Це природний перший виклик для прогнозної шкали часу: відрендерити послідовність великих періодів, підсвітити той, що активний на задану дату, і дати користувачам заглиблюватися далі. Оскільки весь ланцюг детерміновано випливає з одного положення Місяця, його можна обчислити раз під час реєстрації й кешувати безстроково. Коли знадобляться вкладені підперіоди всередині конкретної махадаші, переходьте до окремих ендпоінтів антардаша, пратьянтар, сукшма та прана з того ж сімейства Вімшоттарі.

// 05 / Нотатки

Нотатки

Цей маршрут повертає лише шар махадаш (великих періодів). Тонші підрозділи — антардаша, пратьянтар, сукшма та прана — розташовані на окремих ендпоінтах під /v1/vedic/dashas/vimshottari/*. Розрахунок дотримується традиції Парашари, кодифікованої в «Бріхат Парашара Хора Шастра», із сидеричним зодіаком та аянамшою Lahiri як усталеною системою відліку.

Спробуйте Махадаша Вімшоттарі API

Отримайте ключ і зробіть перший виклик за хвилину.

99.9% SLA · платні плани · 30d status →