DESTINYAPI · Developer Portal

자미두수 API

중국 전통 자미두수(紫微斗數) 명반을 분석하는 API입니다. 생년월일시를 기반으로 12궁, 14정성, 사화, 대운 등을 계산하고 해석합니다.

종합 자미두수 분석

POST/v1/jami/analysis인증 필요

사주 정보를 바탕으로 자미두수 통합 결과(선천명반, 대한, 유년)를 반환합니다.

요청 파라미터

파라미터

이름타입필수설명
input_dataobject필수

자미두수 출생 정보

input_data.namestring필수

이름

예시: 홍길동

input_data.birthdatestring필수

생년월일 (YYYY-MM-DD 형식)

예시: 1985-06-18

input_data.is_lunarboolean선택

음력 여부

예시: true

기본값: false

input_data.is_leap_monthboolean선택

윤달 여부 (음력인 경우만)

예시: false

기본값: false

input_data.birth_timestring필수

태어난 시간 (HH:MM 형식, 24시간제)

예시: 22:00

input_data.genderstring필수

성별 (M: 남자, F: 여자)

예시: F

target_year_ganjistring선택

유년 분석을 위한 목표 년도 간지 (예: "갑신")

예시: 갑신

요청 예제

curl -X POST https://api.destinyapi.com/v1/jami/analysis \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "input_data": {
    "name": "홍길동",
    "birthdate": "1985-06-18",
    "birth_time": "22:00",
    "gender": "F",
    "is_lunar": true,
    "is_leap_month": false
  },
  "target_year_ganji": "갑신"
}'

성공 응답

200 OK - 자미두수 분석 성공

응답 상태:200
{
  "success": {
    "납음오행": "천중수",
    "국수": 2,
    "명궁": "신",
    "십이궁": {
      "명궁": "갑신",
      "형제궁": "계미",
      "부처궁": "임오",
      "자녀궁": "신사",
      "재백궁": "경진",
      "질액궁": "기묘",
      "천이궁": "무인",
      "노복궁": "기축",
      "관록궁": "무자",
      "전택궁": "정해",
      "복덕궁": "병술",
      "부모궁": "을유"
    },
    "자미": "술",
    "14정성 및 보좌성": {
      "자미": "술",
      "천기": "유",
      "태양": "미",
      "무곡": "오",
      "천동": "사",
      "염정": "인",
      "천부": "오",
      "태음": "미",
      "탐랑": "신",
      "거문": "유",
      "천상": "술",
      "천량": "해",
      "칠살": "자",
      "파군": "진",
      "좌보": "유",
      "우필": "사"
    },
    "문창문곡": [
      "해",
      "묘"
    ],
    "녹존타라경양": {
      "녹존": "묘",
      "타라": "인",
      "경양": "진"
    },
    "천마": "해",
    "화성영성지공지겁": {
      "화성": "인",
      "영성": "유",
      "지공": "자",
      "지겁": "술"
    },
    "화성영성관계": "만나지 않음",
    "지공지겁관계": "해궁 협함",
    "사화": {
      "화록": "천기",
      "화권": "천량",
      "화과": "자미",
      "화기": "태음"
    },
    "천형천요천공": {
      "천형": "인",
      "천요": "오",
      "천공": "인"
    },
    "순공": [
      "술",
      "해"
    ],
    "절공": [
      "오",
      "미"
    ],
    "삼태": "인",
    "팔좌": "자",
    "은광": "묘",
    "천귀": "미",
    "태보": "사",
    "봉고": "축",
    "용지": "사",
    "봉각": "유",
    "천관천복": [
      "진",
      "신"
    ],
    "천재": "유",
    "천무": "신",
    "해신(월)": "자",
    "해신(년)": "축",
    "월덕": "오",
    "천주": [
      "오"
    ],
    "홍란천희": [
      "인",
      "신"
    ],
    "대모": "오",
    "항지": "오",
    "홍염": "신",
    "천곡천허": [
      "사",
      "미"
    ],
    "고신과수": [
      "인",
      "술"
    ],
    "음살": "진",
    "겁살화개": [
      "인",
      "축"
    ],
    "비렴": "유",
    "파쇄": "축",
    "천월": [
      "묘",
      "해"
    ],
    "천상천사": [
      "노복궁",
      "질액궁"
    ],
    "장생십이신": {
      "장생": "신",
      "목욕": "유",
      "관대": "술",
      "임관": "해",
      "제왕": "자",
      "쇠": "축",
      "병": "인",
      "사": "묘",
      "묘": "진",
      "절": "사",
      "태": "오",
      "양": "미"
    },
    "박사십이신": {
      "박사": "묘",
      "역사": "진",
      "청룡": "사",
      "소모": "오",
      "장군": "미",
      "주서": "신",
      "비렴": "유",
      "희신": "술",
      "병부": "해",
      "대모": "자",
      "복병": "축",
      "관부": "인"
    },
    "세전십이신": {
      "태세": "축",
      "태양": "인",
      "상문": "묘",
      "태음": "진",
      "관부": "사",
      "사부": "오",
      "세파": "미",
      "용덕": "신",
      "백호": "유",
      "복덕": "술",
      "조객": "해",
      "병부": "자"
    },
    "장전십이신": {
      "장성": "유",
      "반안": "술",
      "세역": "해",
      "식신": "자",
      "화개": "축",
      "겁살": "인",
      "재살": "묘",
      "천살": "진",
      "지배": "사",
      "함지": "오",
      "월살": "미",
      "망신": "신"
    },
    "궁별_성_배치": {
      "자": [
        "칠살",
        "지공"
      ],
      "축": [],
      "인": [
        "염정",
        "타라",
        "화성"
      ],
      "묘": [
        "문곡",
        "녹존"
      ],
      "진": [
        "파군",
        "경양"
      ],
      "사": [
        "천동",
        "우필"
      ],
      "오": [
        "무곡",
        "천부"
      ],
      "미": [
        "태양",
        "태음",
        "화기(태음)"
      ],
      "신": [
        "탐랑"
      ],
      "유": [
        "천기",
        "거문",
        "좌보",
        "영성",
        "화록(천기)"
      ],
      "술": [
        "자미",
        "천상",
        "지겁",
        "화과(자미)"
      ],
      "해": [
        "천량",
        "문창",
        "천마",
        "화권(천량)"
      ]
    },
    "성_밝기": {
      "자미": {
        "위치": "술",
        "밝기": "왕"
      },
      "천기": {
        "위치": "유",
        "밝기": "왕"
      },
      "태양": {
        "위치": "미",
        "밝기": "평"
      },
      "무곡": {
        "위치": "오",
        "밝기": "이"
      },
      "천동": {
        "위치": "사",
        "밝기": "왕"
      },
      "염정": {
        "위치": "인",
        "밝기": "왕"
      },
      "천부": {
        "위치": "오",
        "밝기": "평"
      },
      "태음": {
        "위치": "미",
        "밝기": "평"
      },
      "탐랑": {
        "위치": "신",
        "밝기": "평"
      },
      "거문": {
        "위치": "유",
        "밝기": "평"
      },
      "천상": {
        "위치": "술",
        "밝기": "평"
      },
      "천량": {
        "위치": "해",
        "밝기": "왕"
      },
      "칠살": {
        "위치": "자",
        "밝기": "평"
      },
      "파군": {
        "위치": "진",
        "밝기": "함"
      },
      "좌보": {
        "위치": "유",
        "밝기": "평"
      },
      "우필": {
        "위치": "사",
        "밝기": "평"
      },
      "문창": {
        "위치": "해",
        "밝기": "평"
      },
      "문곡": {
        "위치": "묘",
        "밝기": "평"
      }
    },
    "형충관계": {
      "삼형": {
        "신사형": {
          "궁위": [
            "인",
            "사",
            "신"
          ],
          "발생": true,
          "관련궁": [
            "천이궁",
            "자녀궁",
            "명궁"
          ]
        },
        "축술미형": {
          "궁위": [
            "축",
            "술",
            "미"
          ],
          "발생": true,
          "관련궁": [
            "노복궁",
            "복덕궁",
            "형제궁"
          ]
        },
        "자묘형": {
          "궁위": [
            "자",
            "묘"
          ],
          "발생": true,
          "관련궁": [
            "관록궁",
            "질액궁"
          ]
        }
      },
      "육충": {
        "자오충": {
          "궁위": [
            "자",
            "오"
          ],
          "발생": true,
          "관련궁": [
            "관록궁",
            "부처궁"
          ]
        },
        "축미충": {
          "궁위": [
            "축",
            "미"
          ],
          "발생": true,
          "관련궁": [
            "노복궁",
            "형제궁"
          ]
        },
        "인신충": {
          "궁위": [
            "인",
            "신"
          ],
          "발생": true,
          "관련궁": [
            "천이궁",
            "명궁"
          ]
        },
        "묘유충": {
          "궁위": [
            "묘",
            "유"
          ],
          "발생": true,
          "관련궁": [
            "질액궁",
            "부모궁"
          ]
        },
        "진술충": {
          "궁위": [
            "진",
            "술"
          ],
          "발생": true,
          "관련궁": [
            "재백궁",
            "복덕궁"
          ]
        },
        "사해충": {
          "궁위": [
            "사",
            "해"
          ],
          "발생": true,
          "관련궁": [
            "자녀궁",
            "전택궁"
          ]
        }
      },
      "삼합": {
        "신자진": [
          "신",
          "자",
          "진"
        ],
        "인오술": [
          "인",
          "오",
          "술"
        ],
        "사유축": [
          "사",
          "유",
          "축"
        ],
        "해묘미": [
          "해",
          "묘",
          "미"
        ]
      },
      "육합": {
        "자축합": [
          "자",
          "축"
        ],
        "인해합": [
          "인",
          "해"
        ],
        "묘술합": [
          "묘",
          "술"
        ],
        "진유합": [
          "진",
          "유"
        ],
        "사신합": [
          "사",
          "신"
        ],
        "오미합": [
          "오",
          "미"
        ]
      }
    },
    "격국": {
      "주요격국": [],
      "특수격국": {
        "명칭": "일월병명격",
        "설명": "태양태음이 축궁 또는 미궁에서 만나 음양조화",
        "길흉": "중길"
      },
      "보조격국": [
        "좌보우필조명"
      ]
    },
    "운세_평가": {
      "전체_운": 62,
      "세부": {
        "재물운": 70,
        "직업운": 70,
        "감정운": 70,
        "건강운": 40,
        "대인운": 45,
        "학업운": 80
      },
      "종합_평가": "평범한 운세입니다. 특별히 주의할 분야를 중심으로 관리가 필요합니다."
    },
    "유년십이궁": [
      {
        "ganji": "갑신",
        "original_palace_name": "명궁",
        "annual_palace_name": "명궁",
        "branch": "신"
      },
      {
        "ganji": "계미",
        "original_palace_name": "형제궁",
        "annual_palace_name": "형제궁",
        "branch": "미"
      },
      {
        "ganji": "임오",
        "original_palace_name": "부처궁",
        "annual_palace_name": "부처궁",
        "branch": "오"
      },
      {
        "ganji": "신사",
        "original_palace_name": "자녀궁",
        "annual_palace_name": "자녀궁",
        "branch": "사"
      },
      {
        "ganji": "경진",
        "original_palace_name": "재백궁",
        "annual_palace_name": "재백궁",
        "branch": "진"
      },
      {
        "ganji": "기묘",
        "original_palace_name": "질액궁",
        "annual_palace_name": "질액궁",
        "branch": "묘"
      },
      {
        "ganji": "무인",
        "original_palace_name": "천이궁",
        "annual_palace_name": "천이궁",
        "branch": "인"
      },
      {
        "ganji": "기축",
        "original_palace_name": "노복궁",
        "annual_palace_name": "노복궁",
        "branch": "축"
      },
      {
        "ganji": "무자",
        "original_palace_name": "관록궁",
        "annual_palace_name": "관록궁",
        "branch": "자"
      },
      {
        "ganji": "정해",
        "original_palace_name": "전택궁",
        "annual_palace_name": "전택궁",
        "branch": "해"
      },
      {
        "ganji": "병술",
        "original_palace_name": "복덕궁",
        "annual_palace_name": "복덕궁",
        "branch": "술"
      },
      {
        "ganji": "을유",
        "original_palace_name": "부모궁",
        "annual_palace_name": "부모궁",
        "branch": "유"
      }
    ],
    "두군": "인",
    "유년천괴천월": {
      "유괴": "축",
      "유월": "미"
    },
    "유년녹존타라경양": {
      "유록존": "인",
      "유타라": "축",
      "유경양": "묘"
    },
    "유년문창문곡": {
      "유창": "사",
      "유곡": "유"
    },
    "유년_주요사항": {
      "재물_기회": [],
      "감정_변화": [
        "갑신년"
      ],
      "건강_주의": [],
      "직업_전환": [
        "갑신년"
      ]
    },
    "대한": {
      "갑신": {
        "palace_branch": "신",
        "age_range": "2 ~ 11",
        "original_palace_name": "명궁",
        "daehan_palaces_branches": {
          "명궁": "신",
          "형제궁": "유",
          "부처궁": "술",
          "자녀궁": "해",
          "재백궁": "자",
          "질액궁": "축",
          "천이궁": "인",
          "노복궁": "묘",
          "관록궁": "진",
          "전택궁": "사",
          "복덕궁": "오",
          "부모궁": "미"
        },
        "inner_palaces": [
          "신",
          "술",
          "자",
          "인",
          "진",
          "오"
        ],
        "outer_palaces": [
          "유",
          "해",
          "축",
          "묘",
          "사",
          "미"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "인",
            "is_jin": true
          },
          "권": {
            "palace": "진",
            "is_jin": true
          },
          "과": {
            "palace": "오",
            "is_jin": true
          },
          "기": {
            "palace": "해",
            "is_jin": false
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [
          "축"
        ],
        "secondary_result_palaces": [
          "묘"
        ],
        "대한_해석": {
          "주요_특징": "명궁 대한으로 자아 확립과 정체성의 시기, 탐랑이 주도",
          "길운_요인": "화록이 진궁에서 활성화, 화권이 진궁에서 권위 상승",
          "주의사항": "문제궁위 활성화로 신중함 필요",
          "중점_분야": "자기계발, 정체성 확립"
        }
      },
      "을유": {
        "palace_branch": "유",
        "age_range": "12 ~ 21",
        "original_palace_name": "부모궁",
        "daehan_palaces_branches": {
          "명궁": "유",
          "형제궁": "술",
          "부처궁": "해",
          "자녀궁": "자",
          "재백궁": "축",
          "질액궁": "인",
          "천이궁": "묘",
          "노복궁": "진",
          "관록궁": "사",
          "전택궁": "오",
          "복덕궁": "미",
          "부모궁": "신"
        },
        "inner_palaces": [
          "유",
          "해",
          "축",
          "묘",
          "사",
          "미"
        ],
        "outer_palaces": [
          "술",
          "자",
          "인",
          "진",
          "오",
          "신"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "유",
            "is_jin": true
          },
          "권": {
            "palace": "해",
            "is_jin": true
          },
          "과": {
            "palace": "술",
            "is_jin": false
          },
          "기": {
            "palace": "미",
            "is_jin": true
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [],
        "secondary_result_palaces": [],
        "대한_해석": {
          "주요_특징": "부모궁 대한으로 조상과 윗사람의 시기, 천기, 거문이 주도",
          "길운_요인": "화록이 진궁에서 활성화, 화권이 진궁에서 권위 상승",
          "주의사항": "화기가 진궁에 있어 변동 주의",
          "중점_분야": "가문정리, 효도"
        }
      },
      "병술": {
        "palace_branch": "술",
        "age_range": "22 ~ 31",
        "original_palace_name": "복덕궁",
        "daehan_palaces_branches": {
          "명궁": "술",
          "형제궁": "해",
          "부처궁": "자",
          "자녀궁": "축",
          "재백궁": "인",
          "질액궁": "묘",
          "천이궁": "진",
          "노복궁": "사",
          "관록궁": "오",
          "전택궁": "미",
          "복덕궁": "신",
          "부모궁": "유"
        },
        "inner_palaces": [
          "술",
          "자",
          "인",
          "진",
          "오",
          "신"
        ],
        "outer_palaces": [
          "해",
          "축",
          "묘",
          "사",
          "미",
          "유"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "사",
            "is_jin": false
          },
          "권": {
            "palace": "유",
            "is_jin": false
          },
          "과": {
            "palace": "해",
            "is_jin": false
          },
          "기": {
            "palace": "인",
            "is_jin": true
          }
        },
        "secondary_occurrence_palaces": [
          "축"
        ],
        "problem_palaces": [],
        "secondary_result_palaces": [],
        "대한_해석": {
          "주요_특징": "복덕궁 대한으로 정신적 만족의 시기, 자미, 천상이 주도",
          "길운_요인": "꾸준한 노력으로 성과 달성 가능",
          "주의사항": "화기가 진궁에 있어 변동 주의",
          "중점_분야": "정신수양, 취미생활"
        }
      },
      "정해": {
        "palace_branch": "해",
        "age_range": "32 ~ 41",
        "original_palace_name": "전택궁",
        "daehan_palaces_branches": {
          "명궁": "해",
          "형제궁": "자",
          "부처궁": "축",
          "자녀궁": "인",
          "재백궁": "묘",
          "질액궁": "진",
          "천이궁": "사",
          "노복궁": "오",
          "관록궁": "미",
          "전택궁": "신",
          "복덕궁": "유",
          "부모궁": "술"
        },
        "inner_palaces": [
          "해",
          "축",
          "묘",
          "사",
          "미",
          "유"
        ],
        "outer_palaces": [
          "자",
          "인",
          "진",
          "오",
          "신",
          "술"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "미",
            "is_jin": true
          },
          "권": {
            "palace": "사",
            "is_jin": true
          },
          "과": {
            "palace": "유",
            "is_jin": true
          },
          "기": {
            "palace": "유",
            "is_jin": true
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [
          "해"
        ],
        "secondary_result_palaces": [
          "술"
        ],
        "대한_해석": {
          "주요_특징": "전택궁 대한으로 부동산과 안정의 시기, 천량, 문창이 주도",
          "길운_요인": "화록이 진궁에서 활성화, 화권이 진궁에서 권위 상승",
          "주의사항": "화기가 진궁에 있어 변동 주의, 문제궁위 활성화로 신중함 필요",
          "중점_분야": "부동산, 가족관계"
        }
      },
      "무자": {
        "palace_branch": "자",
        "age_range": "42 ~ 51",
        "original_palace_name": "관록궁",
        "daehan_palaces_branches": {
          "명궁": "자",
          "형제궁": "축",
          "부처궁": "인",
          "자녀궁": "묘",
          "재백궁": "진",
          "질액궁": "사",
          "천이궁": "오",
          "노복궁": "미",
          "관록궁": "신",
          "전택궁": "유",
          "복덕궁": "술",
          "부모궁": "해"
        },
        "inner_palaces": [
          "자",
          "인",
          "진",
          "오",
          "신",
          "술"
        ],
        "outer_palaces": [
          "축",
          "묘",
          "사",
          "미",
          "유",
          "해"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "신",
            "is_jin": true
          },
          "권": {
            "palace": "미",
            "is_jin": false
          },
          "과": {
            "palace": "사",
            "is_jin": false
          },
          "기": {
            "palace": "유",
            "is_jin": false
          }
        },
        "secondary_occurrence_palaces": [
          "미"
        ],
        "problem_palaces": [],
        "secondary_result_palaces": [],
        "대한_해석": {
          "주요_특징": "관록궁 대한으로 사업과 명예의 시기, 칠살이 주도",
          "길운_요인": "화록이 진궁에서 활성화",
          "주의사항": "흉성의 영향으로 충동적 행동 주의",
          "중점_분야": "경력개발, 사업확장"
        }
      },
      "기축": {
        "palace_branch": "축",
        "age_range": "52 ~ 61",
        "original_palace_name": "노복궁",
        "daehan_palaces_branches": {
          "명궁": "축",
          "형제궁": "인",
          "부처궁": "묘",
          "자녀궁": "진",
          "재백궁": "사",
          "질액궁": "오",
          "천이궁": "미",
          "노복궁": "신",
          "관록궁": "유",
          "전택궁": "술",
          "복덕궁": "해",
          "부모궁": "자"
        },
        "inner_palaces": [
          "축",
          "묘",
          "사",
          "미",
          "유",
          "해"
        ],
        "outer_palaces": [
          "인",
          "진",
          "오",
          "신",
          "술",
          "자"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "오",
            "is_jin": false
          },
          "권": {
            "palace": "신",
            "is_jin": false
          },
          "과": {
            "palace": "해",
            "is_jin": true
          },
          "기": {
            "palace": "묘",
            "is_jin": true
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [],
        "secondary_result_palaces": [
          "해"
        ],
        "대한_해석": {
          "주요_특징": "노복궁 대한으로 대인관계와 지원에 집중하는 중년 후기와 전환의 시기",
          "길운_요인": "꾸준한 노력으로 성과 달성 가능",
          "주의사항": "화기가 진궁에 있어 변동 주의",
          "중점_분야": "부하관리, 봉사활동"
        }
      },
      "무인": {
        "palace_branch": "인",
        "age_range": "62 ~ 71",
        "original_palace_name": "천이궁",
        "daehan_palaces_branches": {
          "명궁": "인",
          "형제궁": "묘",
          "부처궁": "진",
          "자녀궁": "사",
          "재백궁": "오",
          "질액궁": "미",
          "천이궁": "신",
          "노복궁": "유",
          "관록궁": "술",
          "전택궁": "해",
          "복덕궁": "자",
          "부모궁": "축"
        },
        "inner_palaces": [
          "인",
          "진",
          "오",
          "신",
          "술",
          "자"
        ],
        "outer_palaces": [
          "묘",
          "사",
          "미",
          "유",
          "해",
          "축"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "신",
            "is_jin": true
          },
          "권": {
            "palace": "미",
            "is_jin": false
          },
          "과": {
            "palace": "사",
            "is_jin": false
          },
          "기": {
            "palace": "유",
            "is_jin": false
          }
        },
        "secondary_occurrence_palaces": [
          "미"
        ],
        "problem_palaces": [],
        "secondary_result_palaces": [],
        "대한_해석": {
          "주요_특징": "천이궁 대한으로 이동과 변화의 시기, 염정이 주도",
          "길운_요인": "화록이 진궁에서 활성화",
          "주의사항": "특별한 주의사항 없이 안정적",
          "중점_분야": "이직, 이사, 여행"
        }
      },
      "기묘": {
        "palace_branch": "묘",
        "age_range": "72 ~ 81",
        "original_palace_name": "질액궁",
        "daehan_palaces_branches": {
          "명궁": "묘",
          "형제궁": "진",
          "부처궁": "사",
          "자녀궁": "오",
          "재백궁": "미",
          "질액궁": "신",
          "천이궁": "유",
          "노복궁": "술",
          "관록궁": "해",
          "전택궁": "자",
          "복덕궁": "축",
          "부모궁": "인"
        },
        "inner_palaces": [
          "묘",
          "사",
          "미",
          "유",
          "해",
          "축"
        ],
        "outer_palaces": [
          "진",
          "오",
          "신",
          "술",
          "자",
          "인"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "오",
            "is_jin": false
          },
          "권": {
            "palace": "신",
            "is_jin": false
          },
          "과": {
            "palace": "해",
            "is_jin": true
          },
          "기": {
            "palace": "묘",
            "is_jin": true
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [],
        "secondary_result_palaces": [
          "해"
        ],
        "대한_해석": {
          "주요_특징": "질액궁 대한으로 건강과 고난의 시기, 문곡이 주도",
          "길운_요인": "꾸준한 노력으로 성과 달성 가능",
          "주의사항": "화기가 진궁에 있어 변동 주의",
          "중점_분야": "건강관리, 위기극복"
        }
      },
      "경진": {
        "palace_branch": "진",
        "age_range": "82 ~ 91",
        "original_palace_name": "재백궁",
        "daehan_palaces_branches": {
          "명궁": "진",
          "형제궁": "사",
          "부처궁": "오",
          "자녀궁": "미",
          "재백궁": "신",
          "질액궁": "유",
          "천이궁": "술",
          "노복궁": "해",
          "관록궁": "자",
          "전택궁": "축",
          "복덕궁": "인",
          "부모궁": "묘"
        },
        "inner_palaces": [
          "진",
          "오",
          "신",
          "술",
          "자",
          "인"
        ],
        "outer_palaces": [
          "사",
          "미",
          "유",
          "해",
          "축",
          "묘"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "미",
            "is_jin": false
          },
          "권": {
            "palace": "오",
            "is_jin": true
          },
          "과": {
            "palace": "미",
            "is_jin": false
          },
          "기": {
            "palace": "사",
            "is_jin": false
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [
          "해"
        ],
        "secondary_result_palaces": [],
        "대한_해석": {
          "주요_특징": "재백궁 대한으로 재물과 경제활동의 시기, 파군이 주도",
          "길운_요인": "화권이 진궁에서 권위 상승",
          "주의사항": "문제궁위 활성화로 신중함 필요, 흉성의 영향으로 충동적 행동 주의",
          "중점_분야": "재산증식, 투자"
        }
      },
      "신사": {
        "palace_branch": "사",
        "age_range": "92 ~ 101",
        "original_palace_name": "자녀궁",
        "daehan_palaces_branches": {
          "명궁": "사",
          "형제궁": "오",
          "부처궁": "미",
          "자녀궁": "신",
          "재백궁": "유",
          "질액궁": "술",
          "천이궁": "해",
          "노복궁": "자",
          "관록궁": "축",
          "전택궁": "인",
          "복덕궁": "묘",
          "부모궁": "진"
        },
        "inner_palaces": [
          "사",
          "미",
          "유",
          "해",
          "축",
          "묘"
        ],
        "outer_palaces": [
          "오",
          "신",
          "술",
          "자",
          "인",
          "진"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "유",
            "is_jin": true
          },
          "권": {
            "palace": "미",
            "is_jin": true
          },
          "과": {
            "palace": "오",
            "is_jin": false
          },
          "기": {
            "palace": "해",
            "is_jin": true
          }
        },
        "secondary_occurrence_palaces": [
          "술"
        ],
        "problem_palaces": [],
        "secondary_result_palaces": [
          "묘"
        ],
        "대한_해석": {
          "주요_특징": "자녀궁 대한으로 자녀와 창조성의 시기, 천동, 우필이 주도",
          "길운_요인": "화록이 진궁에서 활성화, 화권이 진궁에서 권위 상승",
          "주의사항": "화기가 진궁에 있어 변동 주의",
          "중점_분야": "자녀양육, 창작활동"
        }
      },
      "임오": {
        "palace_branch": "오",
        "age_range": "102 ~ 111",
        "original_palace_name": "부처궁",
        "daehan_palaces_branches": {
          "명궁": "오",
          "형제궁": "미",
          "부처궁": "신",
          "자녀궁": "유",
          "재백궁": "술",
          "질액궁": "해",
          "천이궁": "자",
          "노복궁": "축",
          "관록궁": "인",
          "전택궁": "묘",
          "복덕궁": "진",
          "부모궁": "사"
        },
        "inner_palaces": [
          "오",
          "신",
          "술",
          "자",
          "인",
          "진"
        ],
        "outer_palaces": [
          "미",
          "유",
          "해",
          "축",
          "묘",
          "사"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "해",
            "is_jin": false
          },
          "권": {
            "palace": "술",
            "is_jin": true
          },
          "과": {
            "palace": "유",
            "is_jin": false
          },
          "기": {
            "palace": "오",
            "is_jin": true
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [
          "미"
        ],
        "secondary_result_palaces": [
          "사"
        ],
        "대한_해석": {
          "주요_특징": "부처궁 대한으로 배우자운과 인연의 시기, 무곡, 천부이 주도",
          "길운_요인": "화권이 진궁에서 권위 상승, 보조성의 도움",
          "주의사항": "화기가 진궁에 있어 변동 주의, 문제궁위 활성화로 신중함 필요",
          "중점_분야": "결혼, 파트너십"
        }
      },
      "계미": {
        "palace_branch": "미",
        "age_range": "112 ~ 121",
        "original_palace_name": "형제궁",
        "daehan_palaces_branches": {
          "명궁": "미",
          "형제궁": "신",
          "부처궁": "유",
          "자녀궁": "술",
          "재백궁": "해",
          "질액궁": "자",
          "천이궁": "축",
          "노복궁": "인",
          "관록궁": "묘",
          "전택궁": "진",
          "복덕궁": "사",
          "부모궁": "오"
        },
        "inner_palaces": [
          "미",
          "유",
          "해",
          "축",
          "묘",
          "사"
        ],
        "outer_palaces": [
          "신",
          "술",
          "자",
          "인",
          "진",
          "오"
        ],
        "daehan_sahwa": {
          "록": {
            "palace": "진",
            "is_jin": false
          },
          "권": {
            "palace": "유",
            "is_jin": true
          },
          "과": {
            "palace": "미",
            "is_jin": true
          },
          "기": {
            "palace": "신",
            "is_jin": false
          }
        },
        "secondary_occurrence_palaces": [],
        "problem_palaces": [
          "사"
        ],
        "secondary_result_palaces": [
          "유"
        ],
        "대한_해석": {
          "주요_특징": "형제궁 대한으로 인간관계와 협력의 시기, 태양, 태음이 주도",
          "길운_요인": "화권이 진궁에서 권위 상승",
          "주의사항": "문제궁위 활성화로 신중함 필요",
          "중점_분야": "인맥관리, 협력관계"
        }
      }
    }
  }
}

응답 구조

  • 납음오행: 연주의 납음 오행 (천중수, 대해수 등)
  • 국수: 자미두수 국수 (1~5)
  • 명궁: 명궁이 위치한 지지
  • 십이궁: 12궁의 지지 위치 (명궁, 형제궁, 부부궁 등)
  • 자미: 자미성이 위치한 지지
  • 14정성 및 보좌성: 주요 별(자미, 천기, 태양 등)의 위치
  • 대한: 10년 단위 대운 정보
    • palace: 대한 궁위
    • age_range: 해당 대한 연령대
    • daehan_palaces_branches: 대한 기간의 12궁 배치
    • inner_palaces: 내부 궁위
    • outer_palaces: 외부 궁위
    • daehan_sahwa: 대한 사화 (록, 권, 과, 기)
    • secondary_occurrence_palaces: 추가로 활성화되는 궁위 목록
    • problem_palaces: 주의가 필요한 문제 궁위
    • secondary_result_palaces: 부가적인 결과 궁위
  • 유년십이궁: target_year_ganji 제공 시 포함되는 해당 연도의 12궁 배치 (ganji, original_palace_name, annual_palace_name, branch)
  • 유년사화: 해당 연도의 사화 배치 (록/권/과/기가 어떤 지지에 붙는지)
  • 유년천마: 해당 연도의 천마 위치
  • 유년천괴천월: 귀인(천괴)·천월성 위치
  • 유년녹존타라경양: 녹존, 타라, 경양 성의 위치
  • 유년문창문곡: 문창, 문곡 성의 위치
  • 유년이차발생궁: 2차 발생 궁위 리스트
  • 유년문제궁위: 주의가 필요한 문제 궁위 리스트
  • 두군: 두군(斗君) 위치

특별 참고사항

자미두수 기본 개념

자미두수는 중국 전통 명리학으로, 생년월일시를 기반으로 12궁에 배치된 별들의 배치와 상호작용을 분석합니다:

  • 12궁: 명궁, 형제궁, 부부궁, 자녀궁, 재백궁, 질액궁, 천이궁, 노복궁, 관록궁, 전택궁, 복덕궁, 부모궁
  • 14정성: 자미, 천기, 태양, 무곡, 천동, 염정, 천부, 태음, 탐랑, 거문, 천상, 천량, 칠살, 파군
  • 보좌성: 좌보, 우필, 문창, 문곡, 천괴, 천월
  • 사화: 화록(록), 화권(권), 화과(과), 화기(기)
  • 대한: 10년 단위의 대운 (인생의 큰 흐름)
  • 유년: 특정 연도의 운세

성별 표기

gender 파라미터는 다양한 형식을 지원합니다:
- M, F (대문자)
- m, f (소문자)
- Male, Female
- male, female
- yang, yin

일반적인 에러

에러 메시지설명해결 방법
Invalid lunar date provided.음력 날짜를 양력으로 변환할 수 없음입력한 음력 날짜가 유효한지 확인 (1900-2100년 범위)
Cannot convert solar date to lunar date.양력 날짜를 음력으로 변환할 수 없음입력한 양력 날짜가 유효한지 확인
Missing required fields: ...필수 필드가 누락됨요청에 모든 필수 필드가 포함되어 있는지 확인
UNAUTHORIZEDAPI 키가 유효하지 않음API 키 확인 및 재발급
RATE_LIMIT_EXCEEDED요청 제한 초과요청 제한 리셋 시간 대기 또는 플랜 업그레이드

400 Bad Request - 음력 변환 실패

응답 상태:400
{
  "detail": "Invalid lunar date provided."
}

422 Unprocessable Entity - 필수 필드 누락

응답 상태:422
{
  "detail": "Missing required fields: birth_year_ganzi, lunar_year, gender, chart."
}

다음 단계