# Васту-шастра

Васту-шастра кладе будинок на квадратну сітку божеств, **Васту Пуруша Мандалу**, і читає двері, кімнати й воду за тим, куди вони на ній падають. Чотири ендпойнти покривають те, що можна сказати точно. Жоден не приймає зображення плану: ви надсилаєте напрямки, ми повертаємо оцінку і те, звідки вона.

## Ендпойнти

| Ендпойнт | Кредити | Що повертає |
|---|---|---|
| `POST /v1/vastu/mandala` | 10 | Усі 81 клітинку сітки 9x9, 45 божеств, скільки пад у кожного і які клітинки |
| `POST /v1/vastu/entrance` | 10 | У якій із 32 зовнішніх пад стоять головні двері і що про це каже текст |
| `POST /v1/vastu/rooms` | 10 | Кожна кімната: ideal, acceptable, avoid або no-rule, і оцінка 0-100 з формулою |
| `POST /v1/vastu/directions` | 10 | Божество-охоронець, планета, стихія, класичне призначення, вода й підвищення ґрунту для восьми напрямків |

## Звідки правила

Основа це **Бріхат Самхіта, розділ 53**, розділ Варахамігіри про будівництво дому, у перекладі Н. Чидамбарама Айєра 1884 року. Це єдиний класичний текст про Васту, який є суспільним надбанням і має номери віршів, які можна перевірити. У ньому список 45 божеств (53.42-50), наслідок дверей у кожній із 32 зовнішніх пад (53.72-75), що належить чотирьом напрямкам (53.118), що робить водойма в кожному з восьми (53.119) і чим шкодить піднятий ґрунт з кожного боку (53.117).

Друга школа це **Маяматам**, розділ VII. Божества ті самі 45, але чотири зовнішні пади названо інакше і клітинки поділено інакше: її кардинальні божества тримають по 6 пад там, де Бріхат Самхіта дає по 3. Перемикач `school`.

Решта того, що кажуть про Васту, це сучасна практика: де туалет, сходи, септик, спальні. Частина узгоджена між авторами, частина суперечить сама собі. Кожна оцінка у відповіді має `basis`: `classical`, коли за нею стоїть вірш, `convention`, коли ні.

<Aside type="caution">
**Деякі кімнати відхиляються.** Їдальня, балкон, гараж і бак на даху повертають 400. Опубліковані поради для них суперечать одна одній і нічого не цитують, а відповідь, що тихо обирає одну з версій, виглядала б точнісінько як факт.
</Aside>

## Вхід

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vastu/entrance \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{ "side": "N", "position": 0.45 }'
    ```
  </TabItem>
  <TabItem label="Node">
    ```js
    const res = await fetch('https://api.astroway.info/v1/vastu/entrance', {
      method: 'POST',
      headers: { 'X-Api-Key': process.env.ASTROWAY_KEY, 'Content-Type': 'application/json' },
      body: JSON.stringify({ pada: 'N4' }),
    });
    const { data } = await res.json();
    console.log(data.devata, data.verdict, data.source);
    ```
  </TabItem>
</Tabs>

`position` це центр дверей як частка стіни, від кута, з якого ця стіна починається за годинниковою стрілкою: північний схід для східної, південний схід для південної, південний захід для західної, північний захід для північної. Саме в такому порядку лічать вірші. Або надішліть паду напряму, `N4`.

Із 32 пад текст називає **сприятливими 7**: E3, E4, W4, W5, N3, N4, N5. Дві змішані (S4, N1), 23 шкідливі. Вердикт це наше прочитання наслідку, який називає вірш, а `effect` дає сам наслідок, щоб ви прочитали його самі.

<Aside type="note">
**Вісім дверей на стіні з дев'яти клітинок.** У сітки 9 клітинок на бік, а текст називає 8 дверей. `method: "eight-per-side"` (за замовчуванням) ділить стіну на вісім, як інші Васту-API. `method: "mandala-cells"` бере 9 клітинок сітки і віддає кожен кут тій стороні, що з нього починається за годинниковою стрілкою. Ці два способи ставлять деякі двері в різні пади, тож вибір за вами, а двері біля межі пади повертаються з попередженням.
</Aside>

## Кімнати й оцінка

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vastu/rooms \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{ "rooms": [
            { "type": "kitchen", "direction": "SE" },
            { "type": "master-bedroom", "bearing": 225 },
            { "type": "toilet", "direction": "NE" } ] }'
    ```
  </TabItem>
</Tabs>

Напрямок це те, де кімната стоїть від центру будинку: `N`, `NE`, `E`, `SE`, `S`, `SW`, `W`, `NW` або `C` для центру (Брахмастхан). `bearing` у градусах від істинної півночі читається в один із восьми секторів по 45°.

Типи кімнат: `kitchen`, `puja-room`, `store-room`, `underground-water-tank`, `well`, `master-bedroom`, `children-bedroom`, `guest-room`, `study`, `home-office`, `toilet`, `staircase`, `septic-tank`.

**Жоден класичний текст не визначає оцінку Васту**, і кожне API, що її повертає, її вигадало. Наша записана у відповіді, щоб ви могли її перевірити або порахувати свою: правило з віршем важить 2, сучасне 1; ideal дає 1, acceptable 0.5, avoid 0. Розміщення, яке не покриває жодне джерело, це `no-rule`, і воно не входить в оцінку, а не рахується нейтральним. Приклад вище дає 75: кухня ідеальна за віршем, спальня ідеальна за сучасною практикою, туалет на північному сході уникають усі автори.

## Мандала

`POST /v1/vastu/mandala` повертає сітку, де рядок 0 на північному краю, а стовпець 0 на західному, тож клітинка `(0,8)` це північно-східний кут. Кожна клітинка називає своє божество, кожне божество свої пади й клітинки.

У Бріхат Самхіті Брахма тримає центральні 9, чотири божества навколо нього по 3, 20 божеств чотирьох кутових груп по 1, решта 20 зовнішніх по 2. Вірші називають одну клітинку на божество, а не всі, тож клітинки божества на 2 чи 3 пади випливають із підрахунку. Маяматам для чотирьох кутових пар дає лише числа, тож чотири клітинки кожного кутового блоку називають обидва імені.

## Напрямки

`POST /v1/vastu/directions` повертає вісім напрямків з охоронцем (Амаракоша), планетою (Бріхадджатака 2.5) і тим, що каже Бріхат Самхіта: водойма приносить багатство на півночі й синів на північному сході і шкоду деінде; кухня на південному сході, святилище на північному сході. Стихія напрямку не має жодного вірша, а сучасні автори в ній розходяться, тож вона позначена `convention`.

## Чого немає

- **Планів як зображень.** Ви надсилаєте напрямки, з картинки нічого не читається.
- **16 зон MahaVastu.** Це торгова марка однієї школи; самі шістнадцять секторів це звичайний поділ компаса, їх можна порахувати з азимута.
- **Магнітного схилення.** Напрямки від істинної півночі. Компас відрізняється на місцеве схилення.
