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

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

## Ендпоінт

`POST /v1/vedic/dashas/vimshottari/maha`

- Operation ID: `vedic/dashas/vimshottari/maha`
- Вартість: 50 кредитів (тариф 3)
- Типова латентність: 62 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/vedic-dasha/

## Що обчислює

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

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

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

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string (YYYY-MM-DD) | yes | Birth date. |
| `time` | string (HH:MM:SS) | yes | Local clock time at birth. |
| `timezoneOffset` | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| `latitude` | number | yes | Birth-place latitude, decimal degrees (north positive). |
| `longitude` | number | yes | Birth-place longitude, decimal degrees (east positive). |

## Приклад запиту

```bash
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
}'
```

## Приклад відповіді

```json
{
  "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"
      }
    ]
  }
}
```

## Нотатки

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

## Пов’язані техніки

- https://api.astroway.info/astrology-api/vedic-vargas/
- https://api.astroway.info/astrology-api/vedic-shadbala/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md