사주 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 오류 응답은 차감하지 않아요.
한 번 받은 결과는 저장해 두고 다시 쓰세요. 같은 요청을 다시 보내면 다시 과금돼요. 같은 생년월일시·같은 옵션이면 계산 결과가 같으니, 첫 응답을 DB에 저장하고(예: 요청 본문 해시를 키로) 다음부터는 저장한 값을 쓰면 비용이 들지 않아요. 오늘의 운세처럼 날짜에 따라 바뀌는 결과는 날짜도 키에 넣어 그날 하루만 다시 쓰세요.
전체 레퍼런스
파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 오늘의 사주 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.
문의: contact@float.do · 운영: 플로트 주식회사