# Zi Wei Dou Shu: розстановка зірок
**紫微斗數** будує карту не з планет, а з дванадцяти дворців і сотні з гаком зірок, розставлених за правилами від місячної дати і стражі народження. `POST /v1/ziwei/chart` рахує це повністю.
## Ендпоінти
| Ендпоінт | Кредити | Що повертає |
|---|---:|---|
| `POST /v1/ziwei/chart` | 20 | Повна карта: дворці, зірки, стадії, межі, 四化. Потребує `time` і `gender` |
| `POST /v1/ziwei/four-transformations` | 10 | 四化 за стовбуром року, чотири школи |
| `POST /v1/ziwei/twelve-palaces` | 5 | Довідник дванадцяти дворців |
| `POST /v1/ziwei/main-stars` | 5 | Довідник чотирнадцяти головних зірок |
| `POST /v1/ziwei/palace-*` | 5 | Довідник одного дворця, дев'ять шляхів |
Довідкові маршрути несуть поле `computed: false` і коштують половину тарифу. Вони віддають ту саму таблицю будь-якій даті народження, і в цьому немає нічого поганого, поки про це написано.
## Приклад
```bash
curl -X POST https://api.astroway.info/v1/ziwei/chart \
-H "X-Api-Key: $ASTROWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'
```
```json
{
"fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
"soulPalace": { "index": 4, "branch": "Wu" },
"bodyPalace": { "index": 8, "branch": "Xu" },
"ziwei": { "index": 4, "branch": "Wu" },
"annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
"palaces": [
{
"branch": "Wu",
"pillar": "Ren-Wu",
"palace": "destiny",
"isSoul": true,
"majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei", "kind": "major" }],
"lifeStage": { "chinese": "死", "name": "Death", "localised": "Смерть" },
"boshi": "伏兵",
"decade": { "index": 0, "fromAge": 3, "toAge": 12 }
}
]
}
```
Масив `palaces` несе всі дванадцять у тому самому вигляді, від 寅 до 丑.
## Що саме рахується
| Крок | Правило |
|---|---|
| 命宮 і 身宮 | Від дворця місяця назад по стражах для Життя, вперед для Тіла |
| Стовбури дворців | 五虎遁 від стовбура року |
| 五行局 | Зі стовпа дворця Життя; збігається з 納音 на всіх шістдесяти парах |
| 紫微 | Ділення дня на число 局 з позикою: чётна позика вперед, непарна назад |
| 紫微系 (6) | Зміщення −1, −3, −4, −5, −8 від 紫微 |
| 天府系 (8) | 天府 це дзеркало 紫微 навколо осі 寅-申, далі +1..+6 і **+10** для 破軍 |
| 六吉 і 六煞 | Від місяця, стражі і стовбура року, кожна зі своєю формулою |
| Тридцять одна мала зірка | Від гілки року, стовбура року, місяця, дня і стражі |
| 長生十二神 | Від 五行局, вперед для 陽男陰女 і назад інакше |
| 博士十二神 | Від 祿存, той самий напрям |
| 將前 і 歲前 十二神 | Від трійки гілки року і від самої гілки, обидва завжди вперед |
| 大限 | Від 命宮, старт у віці числа 局, крок десять років |
| 小限 | Читає стать і **не читає** інь-ян, на відміну від десятирічних |
| 四化 | За стовбуром року, позначені прямо на зірках |
## Чотири перемикачі школи
Вони в тілі запиту, а не в нашому коді, бо кожен з них зсуває карту цілком для тих народжень, яких торкається.
| Параметр | За замовчуванням | Друге значення |
|---|---|---|
| `yearDivide` | `lunar`: рік починається першим днем першого місячного місяця | `lichun`: межа з BaZi |
| `fixLeap` | `true`: високосний місяць ділиться п'ятнадцятим числом | `false`: увесь високосний рахується попереднім |
| `dayDivide` | `forward`: 23:00 належить наступному дню | `current`: дата лишається, страж позначається як 晚子時 |
| `tianmaSchool` | `year`: 天馬 від гілки року (中州派) | `month`: 天馬 від місячного місяця |
| `school` | `zhongzhou`: 四化 за корпусом 王亭之 | `quanji`, `quanshu`, `beipai` |
## Як це перевірено
Пришпилено до трьох опублікованих карт, а не до однієї бібліотеки, і це навмисно. Майже вся відкрита екосистема Zi Wei походить від одного проєкту: два порти плюс щонайменше один проєкт, який заявляє іншу лінію, а всередині кличе його і розбирає вивід. Тому збіг з кількома проєктами це збіг з одним.
- Дві карти відтворені повністю: усі чотирнадцять головних зірок, 五行局, дворці Життя і Тіла.
- Дванадцять стадій перевірені на третьому фікстурному векторі того ж джерела, де опубліковано очікувані дванадцять, а не на цих двох. Початки десятиліть звірені з числом 五行局, тобто з правилом, з якого виводяться, а не зі сторонньою публікацією.
- Третя карта взята з китайського навчального тексту без стосунку до тієї екосистеми і пришпилює зміщення зірок і порядок дворців самостійно.
- Мнемоніка 安紫微星 「六五四三二／酉午亥辰丑」 і опублікований пробіг 火六局 по днях 1-15 перевіряються прямо: це константи традиції, а не чиясь реалізація.
## Один поширений переказ, який неправильний
火星 і 鈴星 розставляються **вперед від трійки гілки року і не читають стать** у жодній перевіреній передачі. Правило 陽男陰女順 / 陰男陽女逆, яке до них іноді приписують, належить дванадцяти стадіям 長生十二神 і десятирічним межам. Обидві теми стоять на одній сторінці в найчастіше копійованому джерелі, і, схоже, звідти й пішла плутанина.
## Мови
Назви дворців і дванадцяти стадій перекладені на 21 мову: додайте `?lang=`, і в кожному дворці з'явиться `palaceLocalised`, а в стадії поле `localised`. Назви зірок лишаються ієрогліфами з англійським перекладом поруч: усталених імен у них немає.