사주 API › 만세력 API

만세력 API

생년월일시(와 성별·시간대)를 보내면 절기 기준 사주 원국 4주와 원국 분석, 대운·세운을 JSON으로 돌려줘요. 상품 이름은 「만세력」이고, 사주 정체성(identity)도 같은 응답에 들어 있어요. 규칙으로 계산하므로 같은 입력이면 결과가 같아요.

시작 가이드 키 없이 시험해 보기 요금표

돌려주는 것

• 원국 4주 — 년·월·일·시주의 천간·지지와 오행, 십신, 지장간, 12운성, 납음, 신살 (wonkuk)
• 원국 분석 — 오행 분포, 용신, 격국, 신강약, 형충회합, 공망 (ohaengBalance·yongshin·gyeokguk·strength·branchRelations·gongmang)
• 대운·세운 — 대운 목록과 대운수·순역, 올해 세운과 원국의 관계 (daeun·seun)
• 사주 정체성 — 신살 목록·공망·삼재·타임라인 같은 해석용 힌트 (identity)

출생 시각을 모를 때

hour·minute는 생략할 수 있어요. hour를 생략하면 정오로 가정하지 않고 시주를 빼요. 용신·격국·신강약 같은 분석 필드는 년·월·일 3주 기준으로 계산해 그대로 돌려주고, 응답의 birthHour에 3주 기준이라는 표시가 붙어요.

요청 예시

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000, "month": 1, "day": 15, "hour": 14, "minute": 30,
    "gender": "male", "calendar": "solar", "timezone": "Asia/Seoul"
  }'

인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.

응답 예시 (발췌)

{
  "success": true,
  "data": {
    "wonkuk": {
      "year": {
        "stem": "기", "branch": "묘", "stemHanja": "己", "branchHanja": "卯",
        "ohaeng": "토", "stemSipsin": "정관", "branchSipsin": "상관",
        "jijanggan": ["갑", "을"], "chunghyung": [], "hapPosition": ["半合(반합)"],
        "ungSung": "사", "napEum": "성두토",
        "majorSinsal": ["장성살"],
        "minorSinsal": ["천을귀인", "원진살", "현침살", "육해살"]
      },
      "month": { ... },
      "day": { ... },
      "hour": { ... }
    },
    "trueSolarTime": null,
    "ohaengBalance": { "목": 1, "화": 2, "토": 3, "금": 1, "수": 1 },
    "yongshin": "수",
    "johuYongshin": "화",
    "yongshinDetail": {
      "method": "억부",
      "primary": "수",
      "secondary": ["금"],
      "reasoning": ["일간 임(수) 신약 (score=-66)", "신약 + root 있음(8) → 비겁(수)"],
      "shin": { "yongshin": "수", "huishin": "금", "gishin": "토", "gushin": "화", "hanshin": "목" },
      "favorable_sipsin": ["편인", "정인", "비견", "겁재"],
      "unfavorable_sipsin": ["편관", "정관", "편재", "정재", "식신", "상관"],
      "element_states": { "목": { "count": 1, "state": "lack", "effect": "neutral" }, "...": "5오행" }
    },
    "eokbuYongshin": "수",
    "ilganSummary": "壬水 — 큰 바다의 기운. 지혜롭고 포용력이 넓어요.",
    …

2000-01-15 14:30 남성 요청의 앞부분이에요. 대운·세운·격국·신강약까지 담긴 전체 응답과 필드 설명은 레퍼런스에 있어요.

가격

만세력은 호출 1회에 ₩50(부가세 별도 · 부가세 포함 ₩55)이에요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.

전체 요금표 · 키 없이도 플레이그라운드에서 IP당 최대 월 5회 시험할 수 있어요.

전체 레퍼런스

파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 만세력 API 레퍼런스 · 사주 정체성 필드 설명. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.

문의: contact@float.do · 운영: 플로트 주식회사