# Vastu API: план дому, мандала, 16 зон, звіт

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

![Мандала з 81 клітинки поверх плану 12 на 9 метрів: кухня на південному сході, вбиральня на північному сході, двері в паді E3](/vastu-plan-overlay.svg)

## Що повертає API

| Ендпойнт | Кредити | Що повертає |
|---|---|---|
| `POST /v1/vastu/plan` | 20 | Для кожної кімнати й предмета азимут, сектори 8, 16 і 32, клітинку мандали з божеством, вердикт з джерелом; паду дверей; форму контуру; знахідки з виправленнями; оцінку зі смугою |
| `POST /v1/render/vastu` | 20 | SVG у координатах плану з прозорим тлом: мандала, 16 зон або 8 напрямків |
| `POST /v1/reports/vastu` | 5 000 | PDF-звіт під вашим брендом, українською чи англійською; також HTML або Markdown (`format`) |
| `POST /v1/vastu/zones` | 10 | 8, 16 або 32 сектори з точними межами і, якщо передати план, що лежить у кожній зоні |
| `POST /v1/vastu/rooms` | 10 | Вердикт і оцінка за напрямками, якщо план уже виміряно |
| `POST /v1/vastu/entrance` | 10 | Пада головних дверей і її наслідок |
| `POST /v1/vastu/mandala` | 10 | Уся мандала: 45 божеств і їхні клітинки |
| `POST /v1/vastu/directions` | 10 | Вісім напрямків з охоронцями, планетами й класичними правилами |

Повний опис полів, приклади й коди помилок: [документація Васту](/vedic/vastu/).

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

Кожен вердикт має `basis`. `classical` означає, що за ним стоїть вірш, і джерело називає його номер: **Бріхат Самхіта, розділ 53** (переклад Айєра 1884 року, для форми ділянки звірено санскрит), **Маяматам** для другої класичної школи, **Мухурта Чинтамані 12.21** для кімнат шістнадцяти зон. `convention` означає сучасну практику без вірша, і так і написано.

Три школи на вибір: `brihat-samhita` (за замовчуванням), `mayamata` і `sixteen-zone`. Класичні школи рахують азимути від центру прямокутника мандали, школа шістнадцяти зон від центроїда площі; відповідь завжди каже, від якого.

**Caution:**
**Деякі кімнати класичні школи відхиляють.** Їдальня, балкон, гараж і бак на даху не мають класичного правила, тож `brihat-samhita` і `mayamata` повертають 400, а не вигадану відповідь. У школі `sixteen-zone` вони оцінюються, з позначкою `convention`.

## Чого ми не робимо

- **Не читаємо план з картинки.** Геометрію ви передаєте самі, тож картинка плану з адресою на ній не покидає ваш пристрій: до нас приходять лише координати контуру, кімнат і дверей.
- **Не обіцяємо результату.** Виправлення мають трудомісткість і позначку, чи можна їх скасувати, але жодне не обіцяє, що щось зміниться. Ми не пропонуємо товарів: пірамід, янтр, фігурок.
- **Не вигадуємо правил.** Розміщення, якого не покриває жодне джерело, має вердикт `no-rule` і не входить в оцінку.

## Кому це

- **Проптех і агентства нерухомості**: оцінка плану квартири поруч з іншими характеристиками об'єкта.
- **Архітектори й дизайнери інтер'єру**: перевірка ескізу за класичними правилами ще до креслень.
- **Консультанти з Васту**: звіт під власним брендом за хвилину замість ручного розрахунку.
- **Астрологічні платформи**: Васту поруч з картою, тим самим ключем і тими самими кредитами.

## Питання

**Як задати північ, якщо в мене тільки компас?** Передайте кут, `northReference: "magnetic"` і `declination` для вашого місця. Без схилення буде 400: правила читаються від істинної півночі.

**Що з Г-подібним планом?** Його центроїд лежить поза планом. Відповідь про це попереджає, класичні школи рахують від центру прямокутника мандали, а клітинки у вирізі позначено `outsideContour`.

**Скільки коштує звіт?** 5 000 кредитів, як інші PDF-звіти. На безкоштовному тарифі звіти недоступні; розрахунки по 10 і 20 кредитів так.