Huyền Không Phi Tinh (玄空飛星)

Huyền Không Phi Tinh (玄空飛星) là trường phái phong thủy lập bản đồ không phải cho con người mà cho tòa nhà. Chỉ cần hai thông tin, và cả hai đều bắt buộc: vận (thời kỳ) mà tòa nhà được dọn vào ở, và hướng mà tòa nhà nhìn ra. Từ đó suy ra ba con số cho mỗi khu vực trong chín khu vực.

Ba sao trong mỗi cung

Sao	中文	Luận giải về
Sơn tinh	山星	Con người, sức khỏe, các mối quan hệ
Vận tinh	運星	Thời đại mà tòa nhà thuộc về
Hướng tinh	向星	Tiền bạc, cơ hội, sự vận động

Con số của sao và đường bay của nó là số học chính xác. Còn một cặp số có ý nghĩa gì trong một căn phòng cụ thể thì thuộc về truyền thống luận giải, nơi có nhiều hơn một trường phái. Trong response, hai phần này được tách riêng, và notes cho biết phần tính toán kết thúc ở đâu.

Endpoint

Endpoint	Credit	Trả về
POST /v1/chinese/feng-shui/flying-star	10	Bản đồ của tòa nhà: chín cung, loại bản đồ, các cách cục đặc biệt
POST /v1/chinese/feng-shui/annual-stars	10	Sao năm và các sát khí của năm, tùy chọn thêm lớp tháng

Chú ý

Vận không có giá trị mặc định. Nếu không có period hoặc occupiedDate, request trả về 400. Một tòa nhà được dọn vào năm 1998 thuộc vận 7, và một bản đồ vận 9 trông đầy tự tin cho nó sẽ chỉ là một câu trả lời sai với vẻ ngoài đúng.

Ví dụ

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);

Hướng có thể được chỉ định bằng số độ theo chiều kim đồng hồ tính từ phương bắc thật (facing: 180), hoặc bằng tên của một trong 24 sơn: theo mã (S2), theo pinyin (Wu) hoặc theo chữ Hán (午). Vận cũng vậy: bằng số (period: 8) hoặc bằng ngày dọn vào ở (occupiedDate), khi đó năm được tính từ thời điểm chính xác của Lập Xuân, chứ không phải từ ngày cố định 4 tháng 2.

Loại bản đồ

Có bốn cách bố trí kinh điển, và response cho biết bản đồ thuộc loại nào:

id	中文	Luận giải
wang-shan-wang-shui	旺山旺水	Thuận lợi nhất: con người ở phía sau, tiền bạc ở phía trước
shang-shan-xia-shui	上山下水	Đảo ngược; chính ở đây người thực hành sẽ hỏi về địa hình bên ngoài
double-facing	雙星到向	Cả hai sao ở phía trước: tốt cho tiền bạc, cần điểm tựa phía sau
double-sitting	雙星到坐	Cả hai sao ở phía sau: tốt cho con người, cần có nước phía trước

Chúng tôi đã kiểm chứng gì, và bằng cách nào

Quy tắc bay của sao bị phát biểu sai nhiều hơn là đúng. Điều quyết định sao bay thuận hay bay nghịch không phải là âm dương của sơn mà tòa nhà hướng tới, mà là âm dương của sơn ở cùng vị trí thứ tự trong khu vực thuộc quẻ của chính ngôi sao đó.

Cách hiểu ngây thơ chỉ tái tạo đúng 6 trên 24 bản đồ vận 8 đã được công bố và sai ở 18 bản đồ còn lại. Một hai lần kiểm tra có thể bỏ sót lỗi này, vì vậy bộ test chứa toàn bộ tập dữ liệu đã công bố: 24 bản đồ, 9 cung, 3 sao, 648 con số, và tất cả đều khớp.

Sao 5 không có quẻ riêng nên mượn âm dương của Vận tinh. Phiên bản phổ biến thứ hai (“âm dương của cung mà sao 5 đến từ đó”) thực ra là cùng một phiên bản: sao 5 luôn rơi vào cung có số Lạc Thư 10 − vận, và số đó luôn cùng tính chẵn lẻ với vận. Điều này đã được chứng minh cho cả chín vận, chứ không chỉ để lại như một lời lưu ý.

Ghi chú

替卦 (Thế quái, sao thay thế) được cố ý không triển khai. Một số trường phái áp dụng nó khi số đo rơi gần ranh giới giữa hai sơn. Điều này làm thay đổi bản đồ, và các trường phái không thống nhất về điều kiện áp dụng. Thay vì âm thầm chọn một cách, response sẽ cảnh báo: nếu số đo của bạn cách ranh giới sơn dưới 1.5°, warnings sẽ chứa khoảng cách và sơn liền kề.

Sao năm và sát khí

POST /v1/chinese/feng-shui/annual-stars trả về chín sao năm và bốn đến năm sát khí của năm. Sự khác biệt giữa chúng rất quan trọng với người định hành động:

• Thái Tuế (太歲) và Tuế Phá (歲破) mỗi cái chiếm một sơn, mỗi sơn 15°.
• Tam Sát (三煞) chiếm cả một khu vực, 45°.
• Ngũ Hoàng (五黃) và Nhị Hắc (二黑) là các khu vực của bản đồ năm.

Với năm 2026, response đặt Ngũ Hoàng ở phía nam, Thái Tuế ở S2 (午), Tuế Phá ở N2 và Tam Sát ở phía bắc, khớp với các lịch vạn niên đã công bố; bốn giá trị này được cố định bằng test.

Năm ở đây là năm theo tiết khí và bắt đầu từ Lập Xuân. Một ngày trong tháng Một thuộc về năm trước, và chính vì thế không có giá trị nào được điền mặc định: thiếu year hoặc date sẽ trả về 400.

Các endpoint liên quan

Phần còn lại của nhóm phong thủy đã có sẵn trong API và giữ nguyên: POST /v1/chinese/feng-shui/kua (số quái Kua), /lucky-directions (tám hướng cá nhân) và /bagua (bản đồ chín lĩnh vực cuộc sống).