사주 API › 오늘의 운세 API

오늘의 운세 API

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

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

돌려주는 것

날짜와 날씨 옵션

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 오류 응답은 차감하지 않아요.

한 번 받은 결과는 저장해 두고 다시 쓰세요. 같은 요청을 다시 보내면 다시 과금돼요. 같은 생년월일시·같은 옵션이면 계산 결과가 같으니, 첫 응답을 DB에 저장하고(예: 요청 본문 해시를 키로) 다음부터는 저장한 값을 쓰면 비용이 들지 않아요. 오늘의 운세처럼 날짜에 따라 바뀌는 결과는 날짜도 키에 넣어 그날 하루만 다시 쓰세요.

전체 요금표

전체 레퍼런스

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

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