# BaZi (чотири стовпи) API

Один момент народження в увесь класичний апарат: чотири стовпи, приховані стовбури кожної гілки, 纳音, дванадцять стадій життя, баланс стихій по всіх восьми ієрогліфах, оцінка сили в названій рамці, символічні зірки та взаємодії гілок і стовбурів. Один виклик, JSON, 21 мова.

## Ендпоінт

`POST /v1/bazi/chart`

- Operation ID: `bazi/chart`
- Вартість: 20 кредитів (тариф 2)
- Типова латентність: 145 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/bazi-chart/

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

Ендпоінт зводить народження до точних моментів Lichun і 節 з ефемерид, а не з таблиці дат, тому народження за добу від межі потрапляє в правильний рік і місяць. День і година йдуть за годинником місця народження і переходять о 23:00. Далі гілки відкриваються: від одного до трьох прихованих стовбурів у кожній, з роллю і вагою, які дає традиція, і саме там живе більшість стихій карти. Звідти виводяться 纳音 кожного стовпа, стадія денного господаря проти кожної гілки, три окремі рахунки стихій, читання сили 扶抑 з трьома класичними критеріями без ваги, шість символічних зірок від обох опорних стовпів, і всі з'єднання, зіткнення, шкоди й покарання, що є в карті.

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

Беріть замість семи звернень, коли малюєте карту. Односкладові ендпоінти лишаються поруч на випадок, коли потрібна одна таблиця. Якщо ваші користувачі народжені далеко від меридіана свого поясу, передавайте longitude разом з trueSolarTime: Китай тримає один пояс на шістдесят градусів, і народження в Кашгарі відстоїть від сонячного полудня майже на три години, а це ціла подвійна година читання.

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string (YYYY-MM-DD) | yes | Birth date. |
| `time` | string (HH:MM:SS) | no | Local clock time at birth. Without it there is no hour pillar and the analysis runs on six characters, which every field of the response says. |
| `timezoneOffset` | number (hours) | no | The UTC offset the clock was actually running on. A 1988 Beijing birth ran on +9 under summer time; no arithmetic recovers that from the date. |
| `longitude` | number | no | Birth longitude, east positive. Inert unless trueSolarTime is set. |
| `trueSolarTime` | boolean | no | Cut the double-hour from the sun over the birth place. Reaches the day and hour only: the year and month turn on world instants. |
| `stageSchool` | string | no | classical (陽順陰逆, default) or unified (陰陽同生同死) for the twelve life stages. |
| `language` | string | no | Any of 21 codes. Animals, elements, polarity and stage names come back translated; stems and branches stay in pinyin. |

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

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

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

```json
{
  "ok": true,
  "data": {
    "solarYear": 1990,
    "pillars": [
      { "name": "year", "pillar": "Geng-Wu", "animalName": "Horse", "stemElementName": "Metal" },
      { "name": "month", "pillar": "Xin-Si", "animalName": "Snake", "stemElementName": "Metal" }
    ],
    "dayMaster": { "stem": "Geng", "element": "Metal", "polarity": "Yang" },
    "elementBalance": {
      "weighted": { "Wood": 0.4, "Fire": 1.6, "Earth": 1.6, "Metal": 3.3, "Water": 1.1 },
      "missingElements": []
    },
    "strength": { "verdict": "strong", "supportRatio": 0.557, "hasSeason": false, "hasRoot": true },
    "symbolicStars": { "byDayPillar": [ { "english": "Canopy", "pillars": ["day"] } ] },
    "interactions": [ { "english": "Six Harmony", "members": ["Wu","Wei"], "producesElement": "Earth" } ]
  }
}
```

## Нотатки

Там, де традиції справді розходяться, віддаються обидва читання, і відповідь називає розбіжність, а не обирає мовчки: напрям іньських стовбурів у дванадцяти стадіях, обидві позиції іньського леза, вельможа для 庚, стихія з'єднання 午未 і пороги сили, які є конвенцією цього API, а не каноном. Наші чотири відповіді по конвенціях оголошені в disclaimer кожної відповіді й прогнані по CC0-датасету Jade Almanac; результати на сторінці конвенцій.

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

- https://api.astroway.info/astrology-api/vedic-dasha/
- https://api.astroway.info/astrology-api/human-design/
- https://api.astroway.info/astrology-api/natal-chart/

---

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