사주 API › 평생 사주 API

평생 사주 API

생년월일시를 보내면 원국을 계산하고, 차트에 해당하는 풀이 문단을 성격·재물·직업·연애·건강·인간관계·조언 7개 주제로 묶어 JSON으로 돌려줘요. 상품 이름은 「평생 사주」이고, HRUM 사주이론으로 미리 써 둔 문단이라 같은 입력이면 결과가 같아요.

시작 가이드 플레이그라운드 요금표

7개 주제와 주제 하나만

topic을 생략하면 7개 주제를 모두 돌려주고, personality·wealth·career·love·health·relationships·advice 중 하나를 보내면 그 주제만 돌려줘요. 주제 안 문단은 일주, 일간×월지, 신강약, 용신, 오행 상태, 십성 그룹 순서예요.

별자리·자미두수 층

layers: ["astro", "ziwei"]를 보내면 주제마다 별자리(태양·달·상승궁)와 자미두수(명궁 주성, 재물·직업·연애·건강 주제는 그 주제를 맡은 궁의 주성까지) 문단을 더해요. 출생 시각이 없으면 자미두수 층은 빠지고, 빠진 층은 과금하지 않아요.

요청 예시

{
  "year": 1990, "month": 9, "day": 4, "hour": 14, "minute": 30,
  "timezone": "Asia/Seoul", "gender": "male",
  "topic": "career", "lang": "ko"
}

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

응답 예시

{
  "success": true,
  "data": {
    "topics": [
      {
        "topic": "career",
        "paragraphs": [
          { "component": "ilju", "key": "임신", "text": "..." },
          { "component": "ilgan_wolji", "key": "임_신", "text": "..." },
          { "component": "ilgan_strength", "key": "임_신강", "text": "..." },
          { "component": "ilgan_yongshin", "key": "임_화", "text": "..." },
          { "component": "ohaeng_state", "key": "목_lack", "text": "..." },
          { "component": "ohaeng_state", "key": "토_lack", "text": "..." },
          { "component": "ohaeng_state", "key": "수_lack", "text": "..." },
          { "component": "top_sipsin", "key": "인성", "text": "..." }
        ]
      }
    ],
    "lang": "ko",
    "fallbackLanguage": null,
    "engine": { "version": 1, "styleVersion": "v1" }
  }
}

문단 본문(text)은 줄였어요. 전체 필드 설명은 레퍼런스에 있어요.

가격

평생 사주는 전체 1회 ₩100(부가세 별도 · 부가세 포함 ₩110), 주제 1개 1회 ₩20(부가세 별도 · 부가세 포함 ₩22)이에요. 별자리·자미두수 층은 실제로 문단이 붙은 층마다 ₩20(부가세 별도 · 부가세 포함 ₩22)이 더해져요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.

전체 요금표

전체 레퍼런스

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

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