# Час подій за сферами життя - шлюб, кар'єра, діти, нерухомість, закордон, навчання

Шість сфер життя і один виклик для всіх одразу. Кожен ендпоінт відповідає на питання "коли": ділить проміжок до 20 років на вікна там, де змінюється період [Вімшоттарі](/vedic/dashas/) або знак Юпітера чи Сатурна, оцінює кожне вікно за домами й караками сфери і повертає правила, що спрацювали, щоб ваш застосунок міг показати чому.

Кожне правило має поле `basis`: `classical`, коли його називає конкретний текст (BPHS, Пхаладіпіка), `modern`, коли це конвенція XX століття або поширене правило, для якого вірша не знайдено (подвійний транзит, Раху як карака закордону, Юпітер як карака чоловіка), `kp` для Крішнамурті Паддхаті. Бали наші власні й повертаються в кожній відповіді; вони впорядковують вікна, а доказом є правила.

**Note:**
Жодних передбачень і жодного тексту від моделі: вікно - це проміжок дат, бал і список правил. Періоди здоров'я і тривалості життя не пропонуються.

## Ендпоінти

| Ендпоінт | Кредити | Сфера |
|---|---|---|
| `/v1/vedic/timing/marriage` | 50 | 7-й дім, його володар, Венера і Юпітер |
| `/v1/vedic/timing/career` | 50 | 10-й дім, його володар, Сонце і Сатурн |
| `/v1/vedic/timing/children` | 50 | 5-й дім, його володар, Юпітер |
| `/v1/vedic/timing/property` | 50 | 4-й дім, його володар, Марс (земля) і Венера (транспорт) |
| `/v1/vedic/timing/foreign` | 50 | 12-й і 9-й доми, їхні володарі, Раху |
| `/v1/vedic/timing/education` | 50 | 4-й і 5-й доми, їхні володарі, Меркурій і Юпітер |
| `/v1/vedic/timing/all` | 100 | Усі шість або лише ті, що в `areas`, з одного проходу |

## Запит

Дані народження, як для будь-якої карти (`date`, `time`, `latitude`, `longitude`, `timezoneOffset` або `timezone`; `ayanamsaId`, за замовчуванням Лахірі). Доми рахуються від сидеричної Лаґни, тому час і місце обов'язкові.

| Поле | За замовчуванням | Що означає |
|---|---|---|
| `fromDate` | сьогодні | Початок проміжку, YYYY-MM-DD (UTC) |
| `years` | 5 | Довжина проміжку, від 1 до 20 |
| `level` | `pratyantar` (`antar` на `/all`) | Найдрібніший рівень даші, що ділить вікна й оцінюється |
| `kp` | `false` | Додати сигніфікатори KP за куспідами Плацидуса |
| `minScore` | 1 | Не повертати вікна з меншим балом |
| `areas` | усі | Лише `/all`: будь-які з `marriage`, `career`, `children`, `property`, `foreign`, `education` |

```bash
curl -X POST https://api.astroway.info/v1/vedic/timing/marriage \
  -H "X-Api-Key: $ASTROWAY_KEY" -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "15:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52, "fromDate": "2026-11-01", "years": 5 }'
```

## Відповідь

`houses` і `karakas` перелічують, що сфера читає в цій карті, зі знаком і володарем кожного дому. `windows` ідуть за датою; кожне вікно має `start`, `end` (дати UTC; точні `startJd` і `endJd`), `dasha` (володарі маха, антар і пратьянтар), `transitAtStart`, `score`, `components` (`dasha`, `transit`, `kp`), `convergence` і `rules`. Правило - це `{ id, level, planet, house, points, basis, source, rule }`, де `source` - ключ у `sources` сфери, а `rule` називає факт, що спрацював, наприклад "Antardasha lord Jupiter rules the 7th house (Pisces)." `summary` дає кількість вікон, скільки з них збігаються, найвищий бал і п'ять найкращих вікон. `rulesBasis.scoring` повертає бали з таблиці нижче.

Сусідні вікна з тими самими володарями і тими самими правилами зливаються, тож зміна знака Юпітера, яка нічого не змінює, вікно не ділить.

## Правила

| Правило | Бали | Basis | Джерело |
|---|---|---|---|
| `lord-rules-house` | 3 основний дім, 1 допоміжний | classical | Розділи BPHS про плоди даш, Пхаладіпіка, розд. 19: даша дає плоди домів, якими володіє і де стоїть її володар |
| `lord-in-house` | 3 основний, 1 допоміжний | classical | те саме |
| `lord-aspects-house` | 2, лише основні доми | classical | Граха дрішті за BPHS: усі планети аспектують 7-й, Марс також 4-й і 8-й, Юпітер 5-й і 9-й, Сатурн 3-й і 10-й |
| `karaka` | 2 класична карака, 1 сучасна | за каракою | BPHS, розд. 32, Пхаладіпіка, розд. 2, або сучасна конвенція |
| `node-dispositor` | 2, основні доми | modern | Раху і Кету дають плоди володаря свого знака: поширене правило, вірша не знайдено |
| `double-transit-house` | 4 | modern | К. Н. Рао: Юпітер і Сатурн обидва стоять у домі або аспектують його |
| `double-transit-lord` | 3 | modern | К. Н. Рао: обидва стоять у знаку, де стоїть володар дому, або аспектують його |
| `kp-significator` | 1 за кожен дім групи KP | kp | Читанки KP: доми володаря накшатри, потім доми самої планети |

Бали даш множаться на вагу рівня: маха 1, антар 1, пратьянтар 0.5. Доми цілими знаками від сидеричної Лаґни; транзити за сидеричним знаком. `convergence` дорівнює true, коли правило маха або антар торкається основного дому чи караки і в тому самому вікні спрацьовує подвійний транзит: за К. Н. Рао, "даша обіцяє, транзит призначає час".

## Сфери

| Сфера | Основні доми | Допоміжні | Караки | Група KP |
|---|---|---|---|---|
| marriage | 7 (classical, BPHS, розд. 18) | 2, 11 (modern) | Венера (classical, BPHS, розд. 32), Юпітер (modern) | 2, 7, 11 |
| career | 10 (classical, BPHS, розд. 21) | 6, 11, 2 (modern) | Сонце, Сатурн (classical, BPHS, розд. 32) | 2, 6, 10, 11 |
| children | 5 (classical, BPHS, розд. 16) | 9 (modern, бхават бхавам) | Юпітер (classical) | 2, 5, 11 |
| property | 4 (classical, BPHS, розд. 15) | 11 (modern) | Марс, Венера (classical, Пхаладіпіка, розд. 2) | 4, 11, 12 |
| foreign | 12, 9 (modern) | 3 (modern) | Раху (modern) | 3, 9, 12 |
| education | 5 (classical), 4 (modern) | 9 (modern) | Меркурій, Юпітер (classical, Пхаладіпіка, розд. 2) | 4, 9, 11 |

Номери розділів BPHS за перекладом Сантханама, з точністю до розділу, а не вірша. BPHS називає караками 10-го дому також Меркурій і Юпітер; у кар'єрі їх немає, бо Юпітер - карака п'яти домів і спрацьовував би в кожній сфері.

## Розібраний приклад

Київ, 15 травня 1990, 15:30 (UTC+3). Лаґна Діва, отже 7-й дім - Риби, а його володар Юпітер стоїть у Близнюках. Вікно шлюбу від 17 лютого 2029: маха Юпітер, антар Юпітер, пратьянтар Кету, Юпітер у Терезах, Сатурн в Овні:

- маха Юпітер володіє 7-м: 3, і є каракою (modern): 1
- антар Юпітер, те саме: 3 + 1
- пратьянтар Кету стоїть у Раку, 11-му домі (допоміжному): 1 x 0.5
- Юпітер у Терезах аспектує свій 9-й, Близнюків; Сатурн в Овні аспектує свій 3-й, Близнюків: обидва дістають володаря 7-го, `double-transit-lord` 3

Бал 11.5 (даша 8.5, транзит 3), `convergence` true. Тести закріплюють це вікно правило за правилом.

## З чим звірено

Жоден інший API не публікує правил за своїми вікнами часу, тож порівняти немає з чим. Правила закріплені розібраними вручну випадками в тестах, а періоди даш беруться з того самого дерева, що й в ендпоінтах Вімшоттарі: антардаші махадаші, що йде при народженні, рахуються від її умовного початку, як у текстах.

  - [Даші](/vedic/dashas/): Вімшоттарі і ще дев'ять систем
  - [Мухурта](/vedic/muhurat/): День і година, коли вікно вже відоме
  - [Підбір пари](/vedic/matchmaking/): Порутхам, доші, сумісність за дашами
  - [Кредити](/credits/): Вартість кожного ендпоінта в кредитах