Zi Wei Dou Shu (Purple Star) API

출생 정보를 음력 날짜로 변환해, Zi Wei는 순수 음력 시스템이라 BaZi와 달리 절기 전환이 없어. 음력 월과 시(두 시간)로 영혼 궁과 몸 궁을 정하고, 오호랑이 규칙으로 각 궁에 기둥을 달아. 그 다음 영혼 궁 기둥에서 오행 클래스를 읽어. 그 클래스와 음력 일자를 이용해 고전적인 빌리기·나누기 규칙으로 紫微를 배치하고, 그 시리즈의 6별이 고정 오프셋으로 따라와. 天府는 寅-申 축을 기준으로 거울처럼 반사하고 자체 8별을 가짐. 이 골격 위에 행운 6별과 악운 6별, 급여 별, 천마, 연주, 연지, 월지, 일지, 시지에 각각 연결된 31개의 소별, 12개의 인생 단계, 학자 주기, 장군 주기, 연도 주기, 클래스 번호에서 시작되는 10년 제한, 나이를 물으면 연간 제한까지 추가돼. 4개의 변환은 연주에서 결정돼 별 자체에 붙어 반환되지 않아.

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

{
  "ok": true,
  "data": {
    "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" }],
        "lifeStage": { "chinese": "死", "name": "Death" },
        "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
      }
    ]
  }
}

중국 점성 제품을 만들면서 중국어가 아닌 언어를 쓰는 시장을 목표로 할 때 써. 앱, 리딩 서비스, 차트 렌더러, 해석 전에 구조가 필요한 에이전트 등에 적합해. 응답은 순수 구조만 제공하고 문장은 없어서 12궁 그리드, 보고서 생성기, LLM 프롬프트 어디에든 바로 넣을 수 있어. 같은 계열의 레퍼런스 엔드포인트는 더 저렴하고 용어집·툴팁에 유용하지만, 모든 출생에 대해 같은 표를 반환하고 필드에 그렇게 적혀 있으니 차트 만들 때 쓰지 마.

하나의 라이브러리 대신 세 개의 공개 차트에 고정했어, 일부러. 거의 전체 오픈소스 Zi Wei 생태계가 단일 프로젝트에서 파생됐으니 여러 차트를 따르는 건 하나를 따르는 것과 같아. 두 개의 전체 차트는 정확히 재현되고, 세 번째는 별도 교육 자료에서 나와. 네 개의 학교 스위치는 코드가 아니라 요청 본문에 있어, 각각 연도 경계, 윤달, 23:00 넘김, 변환 표 때문에 해당 출생 차트를 전체 이동시켜. 다른 계산기가 다르면, 연산 전에 그 네 가지를 확인해.