八字 API › 萬年曆 API

萬年曆 API

只要傳送出生年月日時（以及性別、時區），就會以 JSON 回傳以節氣為基礎的八字命盤（原局）四柱、命盤分析，以及大運、流年。商品名稱為「萬年曆」，同一個回應中也包含八字特質（Saju Identity）。依規則計算，因此相同輸入就會得到相同結果。

入門指南免金鑰試用價目表

回傳內容

命盤四柱 — 年柱、月柱、日柱、時柱的天干、地支與五行，十神、藏干、十二長生、納音、神煞 (wonkuk)
命盤分析 — 五行分布、用神、格局、身強弱、刑沖會合、空亡 (ohaengBalance·yongshin·gyeokguk·strength·branchRelations·gongmang)
大運、流年 — 大運清單與起運歲數、順逆，今年流年與命盤的關係 (daeun·seun)
八字特質 — 神煞清單、空亡、三災、時間軸等解讀用提示 (identity)

不知道出生時刻時

hour·minute 可以省略。省略 hour 時，不會假設為正午，而是不排時柱。用神、格局、身強弱等分析欄位會以年、月、日三柱計算後照常回傳，回應的 birthHour 會標示為三柱計算。

請求範例

curl -X POST https://api.hrum.ai/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000, "month": 1, "day": 15, "hour": 14, "minute": 30,
    "gender": "male", "calendar": "solar", "timezone": "Asia/Seoul"
  }'

驗證使用 X-Partner-Api-Key 標頭，基本網址為 https://api.hrum.ai/api/v1/partners/v1。Python、JavaScript 範例與錯誤處理請見入門指南。

回應範例（節錄）

{
  "success": true,
  "data": {
    "wonkuk": {
      "year": {
        "stem": "기", "branch": "묘", "stemHanja": "己", "branchHanja": "卯",
        "ohaeng": "토", "stemSipsin": "정관", "branchSipsin": "상관",
        "jijanggan": ["갑", "을"], "chunghyung": [], "hapPosition": ["半合(반합)"],
        "ungSung": "사", "napEum": "성두토",
        "majorSinsal": ["장성살"],
        "minorSinsal": ["천을귀인", "귀문관살", "원진살", "현침살", "육해살"]
      },
      "month": { ... },
      "day": { ... },
      "hour": { ... }
    },
    "trueSolarTime": null,
    "ohaengBalance": { "목": 1, "화": 2, "토": 3, "금": 1, "수": 1 },
    "yongshin": "수",
    "johuYongshin": "화",
    "yongshinDetail": {
      "method": "억부",
      "primary": "수",
      "secondary": ["금"],
      "reasoning": ["일간 임(수) 신약", "신약 + root 있음(8) → 비겁(수)"],
      "shin": { "yongshin": "수", "huishin": "금", "gishin": "토", "gushin": "화", "hanshin": "목" },
      "favorable_sipsin": ["편인", "정인", "비견", "겁재"],
      "unfavorable_sipsin": ["편관", "정관", "편재", "정재", "식신", "상관"],
      "element_states": { "목": { "count": 1, "state": "lack", "effect": "neutral" }, "...": "5오행" }
    },
    "eokbuYongshin": "수",
    "ilganSummary": "壬水 — 큰 바다의 기운. 지혜롭고 포용력이 넓어요.",
    …

這是 2000-01-15 14:30 男性請求的回應開頭。包含大運、流年、格局、身強弱的完整回應與欄位說明請見參考文件。

價格

萬年曆每次呼叫 ₩50（VAT 另計 · 含 VAT ₩55）。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

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

完整價目表 · 即使沒有金鑰，也能在 Playground 每個 IP 每月最多試用 5 次。

完整參考文件

完整參數表、回應欄位說明與錯誤代碼都在參考文件中：萬年曆 API 參考文件 · 八字特質欄位說明。其他八字商品請見所有八字 API。

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