Летючі зірки (玄空飛星)

Сюань Кун Фей Сін (玄空飛星) це школа фен-шуй, яка будує карту не для людини, а для будівлі. Двох речей достатньо, і обидві обов’язкові: період, у який будівлю зайняли, і напрямок, у який вона дивиться. З них виводяться три числа на кожен із дев’яти секторів.

Три зірки в кожному палаці

Зірка	中文	Що читають
Гірська	山星	Люди, здоров’я, стосунки
Зірка періоду	運星	Епоха, до якої належить будівля
Лицьова	向星	Гроші, можливості, рух

Число зірки та її політ це точна арифметика. Що означає пара чисел у конкретній кімнаті, це вже інтерпретаційна традиція, у якої більш ніж одна школа. У відповіді ці дві половини розділені, і в notes сказано, де закінчується розрахунок.

Ендпоінти

Ендпоінт	Кредити	Що повертає
POST /v1/chinese/feng-shui/flying-star	10	Натальна карта будівлі: дев’ять палаців, тип карти, особливі візерунки
POST /v1/chinese/feng-shui/annual-stars	10	Річні зірки та ураження року, за бажанням місячний шар

Uwaga

Період не має значення за замовчуванням. Без period або occupiedDate запит повертає 400. Будівля, зайнята 1998 року, належить до періоду 7, і впевнена карта періоду 9 для неї була б просто неправильною відповіддю з правильним виглядом.

Приклад

cURL

curl -X POST https://api.astroway.info/v1/chinese/feng-shui/flying-star \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "period": 8, "facing": 180, "year": 2026 }'

Node

const res = await fetch('https://api.astroway.info/v1/chinese/feng-shui/flying-star', {
  method: 'POST',
  headers: { 'X-Api-Key': process.env.ASTROWAY_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ occupiedDate: '2011-06-01', facingMountain: 'S2' }),
});
const { data } = await res.json();
console.log(data.chartType.id, data.palaces.find((p) => p.palace === 'S').pair);

Напрямок можна задати або градусами за годинниковою стрілкою від істинної півночі (facing: 180), або назвою однієї з 24 гір: кодом (S2), піньїнем (Wu) чи ієрогліфом (午). Період так само: числом (period: 8) або датою заселення (occupiedDate), і тоді рік рахується від точного моменту Лічунь, а не від фіксованого 4 лютого.

Тип карти

Чотири канонічні розташування, і відповідь називає те, яке вийшло:

id	中文	Читання
wang-shan-wang-shui	旺山旺水	Найсприятливіше: люди позаду, гроші попереду
shang-shan-xia-shui	上山下水	Обернене; саме тут практик питає про ландшафт назовні
double-facing	雙星到向	Обидві зірки попереду: добре для грошей, потрібна опора позаду
double-sitting	雙星到坐	Обидві позаду: добре для людей, потрібна вода попереду

Що ми перевірили, і чим

Правило польоту зірки формулюють неправильно частіше, ніж правильно. Зірку відправляє вперед чи назад не полярність гори, у яку дивиться будівля, а полярність гори на тій самій порядковій позиції в секторі власної триграми зірки.

Наївне прочитання відтворює 6 з 24 опублікованих карт періоду 8 і провалює 18. Одна-дві перевірки його б пропустили, тому в тестах лежить увесь опублікований набір: 24 карти, 9 палаців, 3 зірки, 648 чисел, і всі збігаються.

Зірка 5 не має власної триграми й позичає полярність зірки періоду. Друга поширена версія («полярність палацу, з якого 5 прийшла») це та сама версія: 5 завжди опиняється в палаці з числом Ло Шу 10 − період, а воно завжди має парність періоду. Це доведено для всіх дев’яти періодів, а не залишено як застереження.

Notatka

替卦 (заміщувальні зірки) свідомо не реалізовані. Частина шкіл застосовує їх, коли вимір потрапляє близько до межі гори. Це змінює карту, а школи не згодні щодо умов. Замість тихого вибору відповідь попереджає: якщо ваш вимір ближче ніж 1.5° до межі, у warnings буде відстань і сусідня гора.

Річні зірки та ураження

POST /v1/chinese/feng-shui/annual-stars дає дев’ять річних зірок і чотири-п’ять уражень року. Різниця між ними важлива для того, хто збирається діяти:

• Тай Суй (太歲) і Суй По (歲破) це по одній горі, 15° кожна.
• Сан Ша (三煞) це цілий сектор, 45°.
• П’ять жовтих (五黃) і дві чорні (二黑) це сектори річної карти.

Для 2026 року відповідь ставить п’ять жовтих на південь, Тай Суй на S2 (午), Суй По на N2 і Сан Ша на північ, що збігається з опублікованими альманахами; ці чотири значення зафіксовані тестом.

Рік тут сонячний і починається на Лічунь. Дата в січні належить до попереднього року, і саме тому нічого не підставляється за замовчуванням: без year або date буде 400.

Що поруч

Решта фен-шуй-поверхні вже жила в API й лишається на місці: POST /v1/chinese/feng-shui/kua (число Гуа), /lucky-directions (вісім особистих напрямків) і /bagua (карта дев’яти сфер життя).