현공비성 (玄空飛星)

현공비성(玄空飛星)은 사람이 아니라 건물의 명반을 작성하는 풍수 유파입니다. 필요한 것은 두 가지이며, 둘 다 필수입니다: 건물에 입주한 시기의 운(period)과 건물이 향하는 방향입니다. 이 두 값에서 아홉 개 섹터마다 세 개의 숫자가 도출됩니다.

각 궁의 세 별

별	中文	읽는 대상
산성	山星	사람, 건강, 관계
운성	運星	건물이 속한 시대
향성	向星	재물, 기회, 흐름

별의 숫자와 그 비행은 정확한 산술입니다. 특정 방에서 숫자의 조합이 무엇을 의미하는지는 해석 전통의 영역이며, 이 전통에는 유파가 둘 이상 있습니다. 응답에서는 이 두 부분이 분리되어 있고, notes에 계산이 어디서 끝나는지 명시되어 있습니다.

엔드포인트

엔드포인트	크레딧	반환 내용
`POST /v1/chinese/feng-shui/flying-star`	10	건물의 명반: 구궁, 반국 유형, 특수 패턴
`POST /v1/chinese/feng-shui/annual-stars`	10	연간 비성과 연간 흉살, 선택적으로 월간 레이어

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 }'

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)로 지정할 수 있으며, 후자의 경우 연도는 고정된 2월 4일이 아니라 입춘의 정확한 시점부터 계산됩니다.

반국 유형

네 가지 정통 배치가 있으며, 응답은 해당하는 유형의 이름을 알려 줍니다:

id	中文	해석
`wang-shan-wang-shui`	旺山旺水	가장 길한 배치: 사람은 뒤에, 재물은 앞에
`shang-shan-xia-shui`	上山下水	반대 배치. 바로 이 경우에 풍수가는 바깥의 지형을 묻습니다
`double-facing`	雙星到向	두 별이 모두 앞에: 재물에 좋으며, 뒤에 받쳐 주는 산이 필요합니다
`double-sitting`	雙星到坐	두 별이 모두 뒤에: 사람에 좋으며, 앞에 물이 필요합니다

무엇을, 무엇으로 검증했는가

별의 비행 규칙은 올바르게보다 틀리게 설명되는 경우가 더 많습니다. 별을 순행시킬지 역행시킬지 결정하는 것은 건물이 향하는 산의 음양이 아니라, 그 별 자신의 괘 섹터에서 같은 순번 위치에 있는 산의 음양입니다.

순진한 해석은 공개된 8운 반국 24개 중 6개만 재현하고 18개는 틀립니다. 한두 번의 검사로는 놓칠 수 있기 때문에, 테스트에는 공개된 전체 세트가 들어 있습니다: 24개 반국, 9개 궁, 3개 별, 648개 숫자가 모두 일치합니다.

5번 별은 자신의 괘가 없어서 운성의 음양을 빌려 옵니다. 널리 퍼진 또 다른 설명(“5가 온 궁의 음양”)은 같은 규칙입니다: 5는 항상 낙서 숫자가 10 − period인 궁에 들어가고, 그 숫자는 항상 운과 홀짝이 같습니다. 이는 주의 사항으로 남겨 둔 것이 아니라 아홉 개 운 모두에 대해 증명되었습니다.

연간 비성과 흉살

POST /v1/chinese/feng-shui/annual-stars는 아홉 개의 연간 비성과 네다섯 개의 연간 흉살을 반환합니다. 실제로 조치를 취하려는 사람에게는 둘의 차이가 중요합니다:

태세(太歲)와 세파(歲破)는 각각 산 하나, 15°입니다.
삼살(三煞)은 섹터 전체, 45°입니다.
오황(五黃)과 이흑(二黑)은 연간 반국의 섹터입니다.

2026년의 경우 응답은 오황을 남쪽에, 태세를 S2(午)에, 세파를 N2에, 삼살을 북쪽에 배치하며, 이는 공개된 통서(역서)와 일치합니다. 이 네 값은 테스트로 고정되어 있습니다.

여기서 연도는 태양력 기준이며 입춘에 시작합니다. 1월의 날짜는 전년도에 속하며, 바로 그 때문에 기본값을 대입하지 않습니다: year 또는 date가 없으면 400이 반환됩니다.