八字 API › 合盤 API

合盤 API

只要傳送兩人的出生年月日（與出生時刻），就會一次以 JSON 回傳八字合盤、星座合盤、生肖合盤，以及依用途加權合計的綜合分數。商品名稱為「合盤」，與 INTA 應用程式合盤畫面使用相同的引擎。相同輸入就會得到相同結果。

入門指南 Playground 價目表

回傳內容

• 八字合盤 — 日柱合盤表與八字分析分數，吸引、穩定、成長、溝通、熱情、持久 6 個軸，五行互補，十神 (saju)
• 關係表 — 兩人命盤之間的合、沖、刑、害、破等依位置整理的清單與其分數 (relations·p2Score)
• 星座合盤 — 太陽、月亮、上升點比較與依用途選取的行星，以及最多 2 段預先寫好的解讀段落 (astroSynastry·astroReadings)
• 生肖合盤 — 兩人生肖地支的關係與等級 (tti)
• 綜合分數 — 將五個分數依用途加權合計的 0~100 分 (headerBreakdown)
• 關係解讀段落 — 依兩人日柱組合與關係類型預先寫好的 2~3 句 (categoryNarrative)

選項

出生時刻每個人都可以選擇是否提供。details·flow·MBTI 選項不另收費，可以加在同一次呼叫中。若需要與 INTA 應用程式相同的結果，請為知道出生時刻的人一併傳送出生國家與 exact。

請求範例

這是一併傳送選項（details·flow·MBTI）的請求內容。

{
  "personABirthDate": "1990-05-15", "personABirthTime": "12:00", "personAGender": "male",
  "personBBirthDate": "1992-08-20", "personBBirthTime": "09:00", "personBGender": "female",
  "details": true, "flow": true, "date": "2026-10-10",
  "personAMbti": "ENFP", "personBMbti": "ISTJ"
}

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

回應範例（節錄）

{
  "success": true,
  "data": {
    …
    "saju": {
      "purpose": "yeonae_attraction",
      "hourKnown": { "a": true, "b": true },
      "personA": { "ilju": "임신" },
      "personB": { "ilju": "병인" },
      "score": { "total": 59, "grade": "맞춰 가면 좋아요",
                 "breakdown": { "ilju": 53, "authority": 65, "eightChar": 65 } },
      "axes": { "attraction": 25, "stability": 59, "growth": 58,
                "communication": 24, "passion": 74, "longevity": 65 },
                …

這是從 A 男 1990-09-04 14:30、B 女 1992-02-20 10:15、戀愛用途請求的回應中，只擷取八字合盤開頭的部分。完整回應與欄位說明請見參考文件。

價格

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

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

完整價目表

完整參考文件

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

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