Zi Wei Dou Shu: 별 배열

자미두수는 행성이 아닌, 음력 날짜와 출생 시진에 따라 규칙에 맞춰 배치된 12궁과 100여 개 이상의 별들로 차트를 구성한다. POST /v1/ziwei/chart는 이를 완벽하게 계산한다.

엔드포인트

엔드포인트	크레딧	반환 내용
POST /v1/ziwei/chart	20	전체 차트: 궁, 별, 단계, 대운, 사화. time과 gender 필요
POST /v1/ziwei/four-transformations	10	연간 천간에 따른 사화, 네 가지 학파
POST /v1/ziwei/twelve-palaces	5	12궁 참조
POST /v1/ziwei/main-stars	5	14주성 참조
POST /v1/ziwei/palace-*	5	단일 궁 참조, 9가지 경로

참조 경로에는 computed: false 필드가 포함되며 요금의 절반이 부과된다. 이들은 어떤 생년월일에도 동일한 표를 반환하며, 이 점이 명시되어 있는 한 문제될 것이 없다.

`/ziwei/full-chart`는 더 이상 사용되지 않음

이 엔드포인트는 누구에게나 동일한 궁 사전만 반환하며, 이름은 차트를 약속한다. 2027-11-26까지 변경 없이 응답하며, Deprecation, Sunset, Link 헤더를 후속 엔드포인트로 보낸다. /v1/ziwei/chart로 전환해라: 이 엔드포인트는 날짜와 시간 외에 gender를 추가로 필요로 한다.

예시

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'

{
  "fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
  "soulPalace": { "index": 4, "branch": "Wu" },
  "bodyPalace": { "index": 8, "branch": "Xu" },
  "ziwei": { "index": 4, "branch": "Wu" },
  "annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
  "palaces": [
    {
      "branch": "Wu",
      "pillar": "Ren-Wu",
      "palace": "destiny",
      "isSoul": true,
      "majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei", "kind": "major" }],
      "lifeStage": { "chinese": "死", "name": "Death", "localised": "Death" },
      "boshi": "伏兵",
      "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
    }
  ]
}

palaces 배열은 寅부터 丑까지 12궁 전체를 동일한 형식으로 담고 있다.

계산되는 내용

단계	규칙
명궁 및 신궁	월궁에서 시진을 기준으로 명궁은 뒤로, 신궁은 앞으로
궁의 천간	연간에 따른 오호둔
오행국	명궁의 천간에서; 60갑자 모두 납음과 일치
자미	일수를 국수로 나누고 빌려옴: 짝수 빌려오기는 앞으로, 홀수 빌려오기는 뒤로
자미계 (6)	자미에서 −1, −3, −4, −5, −8만큼 이동
천부계 (8)	천부는 寅-申 축을 중심으로 자미의 거울이며, 이후 +1..+6 및 파군에 대해 +10
육길성 및 육살성	월, 시진, 연간에 따라 각각 고유한 공식으로
31개의 소성	연지, 연간, 월, 일, 시진에 따라
장생12신	오행국에서, 양남음녀는 앞으로, 그 외는 뒤로
박사12신	록존에서, 동일한 방향
장전12신 및 세전12신	연지의 삼합과 연지 자체에서, 둘 다 항상 앞으로
대운	명궁에서, 국수 나이로 시작, 10년 단위
소한	성별을 읽지만, 10년 대운과 달리 음양을 읽지 않는다
사화	연간에 따라, 별에 직접 표시됨

네 가지 학파 스위치

이 스위치들은 우리 코드에 있는 것이 아니라 요청 본문에 있다. 왜냐하면 각각의 스위치가 해당 출생에 대한 차트 전체를 이동시키기 때문이다.

매개변수	기본값	두 번째 값
yearDivide	lunar: 해는 음력 1월 1일에 시작	lichun: 바자이(BaZi)의 입춘 경계
fixLeap	true: 윤달은 15일로 나뉜다	false: 윤달 전체가 이전 달로 계산된다
dayDivide	forward: 23:00은 다음 날에 속한다	current: 날짜는 유지되고, 시진은 만자시(晚子時)로 표시된다
tianmaSchool	year: 연지에서 천마 (중주파)	month: 음력 월에서 천마
school	zhongzhou: 왕정지(王亭之)의 사화	quanji, quanshu, beipai

출생 시간은 필수

명궁은 시진에 따라 정해지며, 명궁에 따라 오행국과 각 별이 결정된다. 시간 없는 차트는 부분적인 응답이 아니라 12궁의 확실한 헛소리가 될 것이므로, time 없는 요청은 400 오류로 거부된다. 이는 시간이 없으면 시주가 없는 바자이(BaZi)와는 다르다.

진태양시

기본적으로 시진은 대부분의 실무자들이 읽는 방식대로 현지 시계에 따라 읽힌다. longitude 및 timezoneOffset과 함께 trueSolarTime: true를 전달하면, 시진이 출생지 위의 태양에 따라 /v1/bazi와 동일한 보정으로 읽힌다. 스페인이나 프랑스 서부에서는 차이가 50분에서 135분 사이이며, 이는 시진이 바뀌고 그에 따라 명궁과 각 별이 바뀌기에 충분하다. 보정은 시진과 날짜에 적용된다; yearDivide=lichun의 경우 입춘 경계는 시계에 따라 유지된다. 무엇이 적용되었는지는 input.trueSolarTime에 반환된다. trueSolarTime 없이 longitude만으로는 아무것도 변경되지 않으며, longitude 또는 timezoneOffset 없이 trueSolarTime을 사용하면 400 TRUE_SOLAR_TIME_NEEDS_PLACE 오류가 발생한다.

여기서 해는 입춘으로 시작하지 않는다

이것은 학파의 선택이 아니다. 자미두수는 순전히 음력 시스템이며, 자평명리와 달리 태양 절기로 넘어가지 않는다. yearDivide=lichun은 바자이(BaZi)의 경계를 가져온 계산기와 대조하기 위해서만 존재한다.

검증 방법

이는 하나의 라이브러리가 아닌 세 가지 공개된 차트에 고정되어 있으며, 의도적인 것이다. 거의 모든 오픈 Zi Wei 생태계는 하나의 프로젝트에서 파생되었다: 두 개의 포트와 최소한 하나의 다른 계보를 주장하지만 내부적으로는 해당 프로젝트를 호출하고 출력을 파싱하는 프로젝트가 있다. 따라서 여러 프로젝트와의 일치는 하나의 프로젝트와의 일치이다.

• 두 개의 차트가 완전히 재현되었다: 14주성, 오행국, 명궁 및 신궁.
• 12단계는 이 두 차트가 아닌, 예상되는 12단계가 게시된 동일한 출처의 세 번째 고정 벡터에서 검증되었다. 10년 대운의 시작은 오행국의 수, 즉 파생되는 규칙과 대조되었으며, 외부 출판물과는 대조되지 않았다.
• 세 번째 차트는 해당 생태계와 관련 없는 중국어 교육 텍스트에서 가져왔으며, 별의 이동과 궁의 순서를 독립적으로 고정한다.
• 안자미성(安紫微星) 암기법 「六五四三二／酉午亥辰丑」과 화육국(火六局)의 1-15일 공개된 진행은 직접적으로 검증된다: 이는 누군가의 구현이 아니라 전통의 상수이다.

계산기가 다른 결과를 줄 때 해야 할 일

산술이 아니라 네 가지 스위치를 확인해라: 연의 경계, 윤달, 23:00의 일 경계, 그리고 사화 표. 거의 항상 차이는 그곳에 있다.

잘못된 일반적인 전승

화성(火星)과 영성(鈴星)은 어떤 검증된 전승에서도 연지의 삼합에서 앞으로 배치되며 성별을 읽지 않는다. 때때로 이들에게 귀속되는 양남음녀순(陽男陰女順) / 음남양녀역(陰男陽女逆) 규칙은 장생12신(長生十二神)의 12단계와 10년 대운에 속한다. 두 주제 모두 가장 자주 복사되는 출처의 한 페이지에 있으며, 혼란은 거기서 시작된 것으로 보인다.

언어

궁의 이름과 12단계는 21개 언어로 번역되었다: ?lang=을 추가하면 각 궁에 palaceLocalised가, 각 단계에 localised 필드가 나타날 것이다. 별의 이름은 옆에 영어 번역과 함께 한자로 유지된다: 정해진 이름이 없기 때문이다.