八字 API › 終身八字 API

終身八字 API

只要傳送出生年月日時，就會計算命盤（原局），並把符合該命盤的解讀段落分成個性、財運、職業、戀愛、健康、人際關係、建議 7 個主題，以 JSON 回傳。商品名稱為「終身八字」，段落是依 HRUM 八字理論預先寫好的，因此相同輸入就會得到相同結果。

入門指南 Playground 價目表

7 個主題全部，或只取一個主題

省略 topic 時回傳全部 7 個主題；傳送 personality·wealth·career·love·health·relationships·advice 其中之一，則只回傳該主題。主題內的段落依日柱、日干×月支、身強弱、用神、五行狀態、十神群組的順序排列。

星座與紫微斗數層

傳送 layers: ["astro", "ziwei"] 時，每個主題會再加上星座（太陽、月亮、上升點）與紫微斗數（命宮主星；財運、職業、戀愛、健康主題還包含負責該主題的宮位主星）段落。沒有出生時刻時會略過紫微斗數層，略過的層不計費。

請求範例

{
  "year": 1990, "month": 9, "day": 4, "hour": 14, "minute": 30,
  "timezone": "Asia/Seoul", "gender": "male",
  "topic": "career", "lang": "ko"
}

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

回應範例

{
  "success": true,
  "data": {
    "topics": [
      {
        "topic": "career",
        "paragraphs": [
          { "component": "ilju", "key": "임신", "text": "..." },
          { "component": "ilgan_wolji", "key": "임_신", "text": "..." },
          { "component": "ilgan_strength", "key": "임_신강", "text": "..." },
          { "component": "ilgan_yongshin", "key": "임_화", "text": "..." },
          { "component": "ohaeng_state", "key": "목_lack", "text": "..." },
          { "component": "ohaeng_state", "key": "토_lack", "text": "..." },
          { "component": "ohaeng_state", "key": "수_lack", "text": "..." },
          { "component": "top_sipsin", "key": "인성", "text": "..." }
        ]
      }
    ],
    "lang": "ko",
    "fallbackLanguage": null,
    "engine": { "version": 1, "styleVersion": "v1" }
  }
}

段落本文（text）已省略。完整欄位說明請見參考文件。

價格

終身八字全部主題每次 ₩100（VAT 另計 · 含 VAT ₩110），一個主題每次 ₩20（VAT 另計 · 含 VAT ₩22）。星座與紫微斗數層，每個實際附上段落的層另加 ₩20（VAT 另計 · 含 VAT ₩22）。只會從預付點數扣除成功的呼叫，4xx、5xx 錯誤回應不扣款。

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

完整價目表

完整參考文件

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

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