八字 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）的回應中，只擷取今日運勢的部分。完整回應與欄位說明請見參考文件。

價格

今日運勢每次呼叫 ₩10（VAT 另計 · 含 VAT ₩11）。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

取得一次的結果請儲存起來重複使用。 再次傳送相同請求會再次計費。相同出生年月日時、相同選項的計算結果相同，因此請把第一次的回應存入資料庫（例如以請求內容的雜湊值作為鍵），之後使用儲存的值就不會產生費用。像今日運勢這類會隨日期改變的結果，請把日期也放進鍵中，只在當天重複使用。

完整價目表

完整參考文件

完整參數表、回應欄位說明與錯誤代碼都在參考文件中：今日運勢 API 參考文件。其他八字商品請見所有八字 API。

聯絡我們：contact@float.do · 營運：FLOAT Co., Ltd.