API китайської метафізики

Оновлено 29 вер. 2026 р. Відкрити як Markdown Налаштування агента

53 ендпоінти на чотири родини: BaZi (18), китайський календар і зодіак (15), Zi Wei Dou Shu (14) та I Ching (6). Календар виведений з ефемерид, а не з таблиць дат, тому працює на роки з 2 по 2899 і не залежить від того, чи хтось оновив довідник.

Що входить

Родина	Ендпоінтів	Стан
BaZi: стовпи і аналіз	18	Повний класичний апарат
Календар, зодіак, фен-шуй, Тун Шу	15	Виведений з ефемерид
Zi Wei Dou Shu	14	Розстановка зірок рахується, одинадцять довідників лишаються довідниками
I Ching	6	Гексаграми, кидок монет, змінні риски

Чим це відрізняється від безкоштовної бібліотеки

Чесна відповідь: якщо потрібні тільки чотири стовпи, беріть lunar-typescript. Він під MIT, рахує у вашому процесі, офлайн, без обмежень частоти, і платити за це не треба.

Різниця починається там, де бібліотека закінчується.

Що	Бібліотеки під MIT	AstroWay API
Чотири стовпи, 藏干, 纳音, 十神	так	так
神煞 з обома читаннями там, де школи розходяться	ні	так
Взаємодії гілок 刑冲合害	ні	так
Сила денного господаря в рамці 扶抑	ні	так
Істинний сонячний час як окремий розрахунок	ні	так
Летючі зірки за сидінням і фасадом, число Гуа	ні	так
Вибір дати Тун Шу з фільтром по діяльності	ні	так
Двадцять одна мова	ні	так
Одна конвенція для PHP, JavaScript і Python одночасно	ні	так

Останній рядок і є тим, за що зазвичай платять. Команда, у якої сайт на PHP, застосунок на JavaScript і крони на Python, інакше тримає три реалізації межі року і рано чи пізно отримує три різні відповіді на одну дату народження.

Конвенції названі вголос

Чотири осі, на яких калькулятори розходяться, і жодна з них не помилка. Більшість реалізацій вибирає мовчки; ми пишемо вибір у відповідь і тримаємо сторінку конвенцій з прогоном по зовнішньому CC0-датасету.

Вісь	Наша відповідь
Межа року	立春 Lichun, точна мить з ефемерид
Межа доби	23:00, ранній 子時 належить наступному дню
Істинний сонячний час	вимкнено за замовчуванням, вмикається прапорцем
Літній час	розв’язується `timezoneOffset`, який надсилає клієнт

Приклад

curl -X POST https://api.astroway.info/v1/bazi/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const r = await aw.client.POST('/bazi/chart', {
  body: { date: '1990-05-15', time: '14:30:00', timezoneOffset: 3 },
});
console.log(r.data?.data?.pillars.map((p) => p.pillar));
// [ 'Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei' ]

import os
from astroway import Astroway

aw = Astroway(api_key=os.environ["ASTROWAY_API_KEY"])

chart = aw.post("/bazi/chart", body={
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
})
print([p["pillar"] for p in chart["pillars"]])
# ['Geng-Wu', 'Xin-Si', 'Geng-Chen', 'Gui-Wei']

Готовий застосунок, який можна клонувати

Живе демо і код на GitHub, MIT.

Два виклики, POST /v1/bazi/chart за 20 кредитів і POST /v1/bazi/luck-pillars за 10, віддають чотири стовпи з прихованими стеблами, на-їнь і дванадцятьма стадіями, господаря дня з вердиктом сили, баланс стихій, символічні зірки, взаємодії гілок і десятирічний цикл Да Юнь. Застосунок їх малює: рік праворуч, як у класичному записі, колонка дня позначена. Бекенд це один маршрут і жодних залежностей, бо саме в ньому суть: браузер не може звернутися до API напряму, тож ключ живе на сервері.

git clone https://github.com/astroway/starter-bazi
cd starter-bazi && npm install
cp .env.example .env     # your key goes here
npm run dev

Три речі, які варто забрати з нього. Надсилайте назву зони, а не зсув: Asia/Shanghai на 1990-05-15 це UTC+9, бо Китай тримав літній час з 1986 до 1991. Надсилайте мову: типова це українська, і англійська сторінка без неї отримає назви стихій не тією мовою. Надсилайте стать: Да Юнь іде вперед або назад залежно від неї, нейтрального значення не існує.

Мови

Тварини, стихії, інь і ян, палаци і дванадцять стадій перекладені на 21 мову. Додайте ?lang=es, і поруч з англійським токеном з’явиться поле *Name. Англійські поля не змінюються ніколи: локалізація додає, а не замінює.

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

Розділи документації

Огляд Що рахується, чого немає і чому.

BaZi: чотири стовпи Вісімнадцять ендпоінтів і п'ять місць, де школи розходяться.

Зодіак і календар Три тварини, місячна дата, двадцять чотири терміни.

Zi Wei Dou Shu Розстановка зірок, дванадцять дворців і чотири перемикачі школи.

Конвенції Чотири осі і прогін по зовнішньому датасету.

Часті питання Невідомий час народження, істинний сонячний час, стан Zi Wei.

Летючі зірки Дев'ять палаців, період, сидіння і фасад.