# Китайський зодіак і календар
Тварина року це найвідоміша частина традиції і найчастіше порахована неправильно. Рік у BaZi починається не 1 січня і не з китайського Нового року, а з **立春 Lichun**, миті, коли видима довгота Сонця доходить до 315°. У 2026 році це `2026-02-03T20:02:08Z`, тобто 4 лютого о 04:02 за пекінським часом. Народжений 2 лютого належить попередній тварині, хоча календар на стіні вже показує новий рік.
## Ендпоінти
| Ендпоінт | Кредити | Що повертає |
|---|---:|---|
| `POST /v1/chinese/zodiac/animal` | 10 | Тварина року, стовп, стихії гілки і стовбура |
| `POST /v1/chinese/zodiac/element` | 10 | Фіксована стихія гілки і циклічна стихія стовбура |
| `POST /v1/chinese/zodiac/inner-animal` | 10 | Внутрішня тварина: гілка місяця |
| `POST /v1/chinese/zodiac/secret-animal` | 10 | Таємна тварина: гілка години |
| `POST /v1/chinese/zodiac/compatibility` | 10 | Сумісність двох тварин за 三合 і 六冲 |
| `POST /v1/chinese/lunar-date` | 10 | Місячна дата, високосний місяць, китайський Новий рік |
| `POST /v1/chinese/solar-terms` | 10 | Усі 24 терміни року з точністю до секунди |
## Три тварини, а не одна
Гороскопи в журналах знають одну тварину. Традиція знає три, і вони відповідають на різні питання.
| Тварина | Звідки | Що означає |
|---|---|---|
| Зовнішня | гілка року | Те, як людину бачать інші |
| Внутрішня | гілка місяця | Мотиви, приватне «я» |
| Таємна | гілка години | Найглибший шар, часто прихований від самої людини |
Внутрішня тварина обмежена точними митями 節, а не серединою місяця, тому народження 5 травня і 6 травня можуть дати різних тварин.
```bash
curl -X POST https://api.astroway.info/v1/chinese/zodiac/inner-animal \
-H "X-Api-Key: $ASTROWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'
```
```json
{
"ok": true,
"data": {
"innerAnimal": "Snake",
"glyph": "🐍",
"description": "Inner animal = the BaZi month branch, bounded by the exact 節 instants. Represents internal motivations and the private self."
}
}
```
## Дві стихії року
Народжений 1990 року це «металевий кінь», і в цьому імені дві різні стихії, які легко сплутати.
- **Циклічна** приходить від небесного стовбура і змінюється кожні два роки: 庚 це метал.
- **Фіксована** належить земній гілці назавжди: 午 це вогонь, і кінь завжди вогняний.
`/chinese/zodiac/element` віддає обидві окремими полями, `fixedElement` і `cyclingElement`, замість того щоб вибирати за клієнта.
## Сумісність
Оцінка будується на 三合 (три гармонії) і 六冲 (шість зіткнень), тобто на геометрії кола гілок, а не на списку думок.
```bash
curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
-H "X-Api-Key: $ASTROWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person1":{"date":"1990-05-15"},"person2":{"date":"1988-02-20"}}'
```
```json
{
"person1": { "solarYear": 1990, "animal": "Horse" },
"person2": { "solarYear": 1988, "animal": "Dragon" },
"compatibility": {
"score": 65,
"category": "good",
"notes": ["Compatible enough; complementary differences."]
}
}
```
## Місячна дата
```bash
curl -X POST https://api.astroway.info/v1/chinese/lunar-date \
-H "X-Api-Key: $ASTROWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-02-17"}'
```
```json
{
"gregorianDate": "2026-02-17",
"lunar": { "month": 1, "isLeapMonth": false, "day": 1, "monthStart": "2026-02-17", "label": "month 1, day 1" },
"chineseNewYear": "2026-02-17"
}
```
Місяць починається з пекінського дня, що містить молодик. Високосний місяць повторює номер попереднього і не містить 中氣: це причина його існування, а не побічний ефект.
## Двадцять чотири сонячні терміни
Термін це не дата з таблиці, а мить, коли видима довгота Сонця стає кратною 15°. Ми беремо її з ефемерид, тому відповідь однакова для будь-якого року в межах домену і не залежить від того, чи хтось оновив таблицю.
```bash
curl -X POST https://api.astroway.info/v1/chinese/solar-terms \
-H "X-Api-Key: $ASTROWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026}'
```
Масив `terms` несе всі двадцять чотири; тут показаний перший:
```json
{
"year": 2026,
"terms": [
{
"index": 0,
"chinese": "立春",
"pinyin": "Lichun",
"english": "Start of Spring",
"sunLongitude": 315,
"utc": "2026-02-03T20:02:08Z",
"beijing": "2026-02-04T04:02:08+08:00",
"opensPillarMonth": true
}
]
}
```
Дванадцять із двадцяти чотирьох несуть `opensPillarMonth: true`: це 節, які відкривають місяць стовпів. Решта дванадцять це 中氣, вони ділять місяць навпіл і визначають, який місяць буде високосним.
## Мови
Тварини і стихії перекладені на 21 мову. Додайте `?lang=` або `"language"` у тілі, і поруч з англійським токеном з'явиться поле `*Name`:
```bash
curl -X POST "https://api.astroway.info/v1/chinese/zodiac/animal?lang=es" \
-H "X-Api-Key: $ASTROWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-05-15"}'
```
```json
{ "animal": "Horse", "animalName": "Caballo", "element": { "fixed": "Fire", "fixedName": "Fuego" } }
```
Англійські поля лишаються на місці назавжди: локалізація додає, а не замінює.