# BaZi: чотири стовпи

**BaZi** (八字, «вісім ієрогліфів») це чотири стовпи народження: рік, місяць, день і година, кожен зі свого небесного стовбура і земної гілки. Стовпи це поверхня. Класичне читання будується на тому, що під ними.

## Ендпоінти

### Стовпи

| Ендпоінт | Кредити | Що повертає |
|---|---:|---|
| `POST /v1/bazi/four-pillars` | 10 | Усі чотири стовпи |
| `POST /v1/bazi/day-master` | 10 | Денний господар і його архетип |
| `POST /v1/bazi/ten-gods` | 10 | Десять богів відносно денного господаря |
| `POST /v1/bazi/luck-pillars` | 10 | Стовпи удачі 大運 із реальним віком старту 起運 |

### Аналіз карти

| Ендпоінт | Кредити | Що повертає |
|---|---:|---|
| `POST /v1/bazi/chart` | 20 | Усе нижче одним викликом |
| `POST /v1/bazi/hidden-stems` | 10 | 藏干: що ховає кожна гілка, з роллю і вагою |
| `POST /v1/bazi/element-balance` | 10 | Баланс стихій по всіх восьми ієрогліфах, трьома способами |
| `POST /v1/bazi/na-yin` | 10 | 納音, звукова стихія кожного стовпа |
| `POST /v1/bazi/life-stages` | 10 | 十二長生, дванадцять стадій |
| `POST /v1/bazi/symbolic-stars` | 10 | 神煞: персикова квітка, кінь, балдахін, вельможа, лезо, порожнеча |
| `POST /v1/bazi/interactions` | 10 | 刑冲合害: з'єднання, зіткнення, шкода, покарання |
| `POST /v1/bazi/strength` | 10 | Сила денного господаря в рамці 扶抑 |

## Приховані стовбури 藏干

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

Ролі: **本氣** основний, **中氣** середній, **餘氣** залишковий. На чотирьох гілках-сховищах (丑辰未戌) середня роль належить **стихії, яку гілка зберігає**, а не другому в списку: 丑 зберігає метал, 辰 воду, 未 дерево, 戌 вогонь. Порядок у списку йде за днями 人元司令, тож на цих чотирьох другим стоїть залишок попереднього сезону.

## Баланс стихій

Три рахунки, а не один, бо практики справді користуються різними, і одне число було б вибором школи в одязі факту.

| Поле | Що рахує |
|---|---|
| `balance.visible` | Чотири стовбури плюс основний прихований стовбур кожної гілки: класичні вісім |
| `balance.withHiddenStems` | Кожен прихований стовбур цілим |
| `balance.weighted` | Гілка ділиться між тим, що ховає, тож сума лишається вісім |

<Aside type="caution" title="Застарілі поля">
`elementCounts`, `dominantElement` і `missingElements` на верхньому рівні рахують **тільки рік і місяць**, чотири ієрогліфи з восьми, і не відкривають гілки. Вони відповідають так само, як відповідали, до **2027-09-08**, і несуть заголовки `Deprecation` і `Sunset` за RFC 8594. Нове живе в `balance`.
</Aside>

## Де школи розходяться

П'ять місць, і в кожному віддаються обидва читання, а не одне.

| Що | Одне читання | Друге |
|---|---|---|
| Напрям янських і іньських стовбурів у дванадцяти стадіях | 陽順陰逆 (`stageSchool=classical`) | 陰陽同生同死 (`stageSchool=unified`) |
| Іньське лезо 陰刃 | за 帝旺 | за 祿前一位 |
| Вельможа 天乙貴人 для 庚 | 三命通會: 丑 і 未 | 淵海子平: 午 і 寅 |
| Стихія з'єднання 午未 | Земля | пара «сонце і місяць», без стихії |
| Пороги сили | 0.55 / 0.45, наша конвенція | канонічного правила немає |

## Сила денного господаря

Рамка одна і названа: **扶抑**, підтримка проти виснаження. Усе, що народжує денного господаря або збігається з ним, підтримує; решта виснажує.

Дві межі сказані прямо в самій відповіді. Місячна гілка рахується так само, як інші три, хоча традиція ставить місяць вище за все, і пороги 0.55 / 0.45 це наша конвенція, а не канон. Тому три класичні критерії (得令 сезон, 得地 корінь, 得勢 союзники) віддаються **без ваги** поруч із відношенням: читач, який зважує місяць, дійде свого висновку з тих самих вхідних.

調候, 通關, 病藥 і 專旺 це інші рамки, вони тут не застосовані і можуть дати протилежний вердикт.

## Істинний сонячний час

```bash frame="terminal"
curl -X POST https://api.astroway.info/v1/bazi/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1995-06-15",
    "time": "09:20:00",
    "timezoneOffset": 8,
    "longitude": 75.9,
    "trueSolarTime": true
  }'
```

Поправка торкається **дня і години**, і на цьому зупиняється: рік і місяць повертаються на моменти світового годинника. Подробиці і ціна помилки на сторінці [конвенцій](/chinese/conventions/).

## Приклад

<Tabs>
  <TabItem label="Уся карта">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/bazi/chart \
      -H "X-Api-Key: aw_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 8, "language": "uk" }'
    ```
  </TabItem>
  <TabItem label="Тільки сила">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/bazi/strength \
      -H "X-Api-Key: aw_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 8 }'
    ```
  </TabItem>
</Tabs>