사주 API › 오늘의 운세 API

오늘의 운세 API

날짜와 생년월일시를 보내면 그날 일진과 내 일간의 관계, 좋은 시간·피할 시간, 행운 색·음식·키워드를 JSON으로 돌려줘요. 상품 이름은 「오늘의 사주」이고, INTA 앱 홈의 「오늘」 카드와 같은 계산이에요. 같은 출생 정보와 같은 날짜면 결과가 같아요.

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

돌려주는 것

• 하루 요약 — 그날 일진, 오늘의 십성, 올해 흐름 점수, 발현 신살, 삼재 여부 (summary)
• 오늘의 운 — 일진과 일간의 관계, 행운 색·음식·키워드, 좋은 시간·피할 시간, 추천 활동, 한 줄 메시지 (omen)
• 활동 적합도 — 활동 7종의 그날 적합도 (taskAffinity)
• 옷차림·MBTI 행동 패턴 — 기온을 보내거나 mbtiBehavior: true일 때만 (fashion·mbtiBehavior)

날짜와 날씨 옵션

date를 생략하면 한국 시간 기준 오늘이에요. temperatureC를 보내면 옷차림이 붙고, weather·humidity까지 보내면 시간대별 한 줄 날씨 코멘트도 붙어요. 출생 시각을 모르면 정오로 계산하고 birthHour를 붙여요.

요청 예시

{
  "year": 1990, "month": 5, "day": 15, "hour": 12, "minute": 0,
  "timezone": "Asia/Seoul", "gender": "male",
  "date": "2026-10-10",
  "temperatureC": 16, "weather": "cloudy", "humidity": 60,
  "mbtiBehavior": true
}

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

응답 예시 (발췌)

{
  "success": true,
  "data": {
    …
    "omen": {
      "relation": { "type": "GEUK", "label": "조율의 날" },
      "color": { "name": "주황", "hex": "#FFA45B", "ohaeng": "화" },
      "food": "고추장비빔밥",
      "keyword": "공개",
      "message": "표현하고 싶은 마음과 주변 반응이 엇갈릴 수 있는 날이에요. 즉흥적인 말보다 한 박자 늦춘 표현이 좋아요.",
      "luckyHour": "오전 11시 ~ 오후 1시",
      "avoidHour": "밤 11시 이후",
      "activity": "칭찬 먼저 하기"
      …

위 요청(2026-10-10) 응답에서 오늘의 운 부분만 뽑았어요. 전체 응답과 필드 설명은 레퍼런스에 있어요.

가격

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

전체 요금표

전체 레퍼런스

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

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