占卜解讀-塔羅牌解讀（新版API）

文件說明

         本API為平臺最新推薦的塔羅占卜方案，基於 Rider–Waite 塔羅體系，並引入五行能量作為輔助語義維度。API無需洗牌或抽牌流程，支援完整大小阿爾克那牌體系，並返回結構化解讀結果，包括牌義、正逆位及綜合解讀分析，適用於內容展示、推薦系統及會員制場景。相較於舊版抽牌API，本API提供更加連貫、穩定的綜合解讀能力，並支援直接生成可用於前端展示或內容輸出的結果。 非會員使用者禁止訪問。

API使用說明

         1. API會自動完成抽牌邏輯，無需使用者參與洗牌或選牌流程， 若需動畫或交互效果，可由對接方自行實現界面表現。
         2. API返回的結果中包含塔羅牌圖片訪問地址（image_url）， 如需獲取完整塔羅牌圖片資料，可點擊 此處 下載對應資源包。

請求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Zhanbu/taluojiedu

請求標頭 (Headers)

欄位 型別 描述
Content-Type String application/x-www-form-urlencoded

請求參數

欄位 型別 描述
api_key String 存取金鑰 (API Key)
spread_id Int 塔羅牌陣編號，決定本次占卜的牌陣結構與返回牌數量，例如：5
1：一張牌占卜法（1 張）
2：二選一牌陣（2 張）
3：聖三角牌陣（3 張）
4：時光箭牌陣（3 張）
5：四元素牌陣（4 張）
6：戀人金字塔（4 張）
7：五行牌陣（5 張）
8：戀人牌陣（5 張）
9：大十字牌陣（5 張）
10：六芒星牌陣（6 張）
11：複合牌陣（6 張）
12：七行星牌陣（7 張）
13：九宮格牌陣（9 張）
14：戀人關係深度牌陣（9 張）
15：凱爾特十字牌陣（10 張）
16：生命之樹牌陣（11 張）
17：年運週期牌陣（12 張）
註： 1.不同牌陣對應不同的卡牌排列方式與位置編號順序
    2.具體牌陣結構請參考下方 牌陣說明（位置編號示意）
topic_id Int 解讀主題編號，用於影響綜合解讀與建議文案風格，不影響抽牌結果，例如：3
1：戀愛婚姻
2：工作學業
3：人際財富
4：健康生活
5：其它綜合
lang String 多語言：zh-cn 、en-us 、zh-tw     
選填，如果不傳遞這個參數，預設為 zh-cn

請求參數範例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'spread_id' => 2,
'topic_id' => 1,
];

回傳參數

欄位 型別 描述
errcode String 狀態碼 0成功 其它為失敗
errmsg String 狀態碼說明
notice String 聲明
data Json 資料內容

成功回傳範例

 {
  "errcode": 0,
  "errmsg": "請求成功",
  "notice": "本次測算結果僅供娛樂使用，請勿用於封建迷信和違法用途。",
  "data": {
    "cards": [  //牌面資訊
      {
        "positions_index": 1,   //牌在牌陣中的順序編號（從 1 開始）
        "positions_name": "選項 A", //該牌陣位置的名稱
        "positions_desc": "選擇方案 A 所呈現的狀態與趨勢", //該牌陣位置的語義說明
        "orientation_code": 1,     //牌正逆的狀態值（1：正位  0：逆位）
        "orientation_text": "正位", //牌正逆的展示文本
        "card_no": 10,             //塔羅牌編號（範圍：1-78）
        "card_name": "隱者",        //塔羅牌的牌名
        "card_keywords": "內省、獨思、智慧覺醒、自我探尋",//塔羅牌關鍵詞
        "card_astrology": "處女座", //塔羅牌星相
        "card_element": "土",      //塔羅牌四元素
        "card_description": "暮色裡，身披灰袍的隱者立於雪山小......", //牌面描述
        "card_interpretation": { //塔羅牌解讀結構
          "general": "土之沉穩與紮根，讓隱者的內省如......",//基本含義
          "topic": "土局的安穩，讓你在親密關係中願......",//主題解讀
          "advice": "順應情感的安穩節奏，接納獨......"   //主題建議
        },
        "image_id": 10, //圖片資源索引
        "image_url": "https://yuanfenju.com/Public/img/taluojiedu/upright/10.jpg" //圖片完整訪問地址
      },
      {
        "positions_index": 2,
        "positions_name": "選項 B",
        "positions_desc": "選擇方案 B 所對應的發展狀態與結果傾向",
        "orientation_code": 1,
        "orientation_text": "正位",
        "card_no": 36,
        "card_name": "權杖國王",
        "card_keywords": "威嚴、熾熱、沉穩掌控、父性力量、篤定自持、剛柔並濟、溫暖引領",
        "card_astrology": "牡羊座",
        "card_element": "火",
        "card_description": "國王穩坐於雕有火焰紋路的檀木王座......",
        "card_interpretation": {
          "general": "你此刻如執一柄沉實的土紋權杖，土的踏實化作沉穩的掌......",
          "topic": "親密關係裡，你像持土焰的國王，帶著熾熱的沉穩對待彼此......",
          "advice": "不必藏起父性的溫柔，像呵護沃土般珍視自己的熾熱，坦誠......",
        },
        "image_id": 36,
        "image_url": "https://yuanfenju.com/Public/img/taluojiedu/upright/36.jpg"
      }
    ],
    "overall_interpretation": { //綜合解讀結構
      "summary_message": "第一張牌所呈現的狀態為「暫時退隱」......", //綜合解讀結果
      "oracle_message": "你值得一個不讓你猜來猜去的人。" //塔羅神諭
    },
    "environment": { //本次解讀所參考的部分環境資訊
      "calculation_time": "2025-12-18 14:58:09", //本次測算的實際計算時間
      "time_ganzhi": "乙未", //本次測算對應的時局干支
      "time_element": "土局" //時局五行，用於輔助結果呈現
    }
  }
}

失敗回傳範例

{
  "errcode": -1,
  "errmsg": "日期有誤",
}

牌陣說明（位置編號示意）

牌陣編號 牌陣名稱 位置編號示意圖
1 一張牌占卜法 
[ 1 ]
2 二選一牌陣 
[ 1 ]   [ 2 ]
3 聖三角牌陣 
    [ 1 ]
[ 2 ]   [ 3 ]
4 時光箭牌陣 
[ 1 ] → [ 2 ] → [ 3 ]
5 四元素牌陣 
    [ 1 ]
[ 2 ]    [ 3 ]
    [ 4 ]
6 戀人金字塔 
      [ 1 ]
[ 2 ] [ 3 ] [ 4 ]
7 五行牌陣 
      [ 1 ]
[ 2 ] [ 3 ] [ 4 ]
      [ 5 ]
8 戀人牌陣 
[ 1 ]     [ 2 ]
     [ 3 ]
[ 4 ]     [ 5 ]
9 大十字牌陣 
      [ 1 ]
[ 2 ] [ 3 ] [ 4 ]
      [ 5 ]
10 六芒星牌陣 
      [ 1 ]
[ 2 ]       [ 3 ]
      [ 4 ]
 [ 5 ]     [ 6 ]
11 複合牌陣 
[ 1 ]   [ 2 ]

[ 3 ]   [ 4 ]

    [ 5 ]
    [ 6 ]
12 七行星牌陣 
    [ 1 ]
[ 2 ]    [ 3 ]
     [ 4 ]
[ 5 ]     [ 6 ]
     [ 7 ]
13 九宮格牌陣 
[ 1 ] [ 2 ] [ 3 ]
[ 4 ] [ 5 ] [ 6 ]
[ 7 ] [ 8 ] [ 9 ]
14 戀人關係深度牌陣 
[ 1 ]              [ 6 ]
    [ 2 ]     [ 7 ]
         [ 3 ]
    [ 8 ]     [ 4 ]
[ 9 ]               [ 5 ]
15 凱爾特十字牌陣 


                  [ 10 ]
      [ 5 ]
      [ 1 ]       [ 9 ]
[ 4 ]       [ 6 ]
      [ 2 ]       [ 8 ]
      [ 3 ]
                  [ 7 ]
16 生命之樹牌陣 

        [ 1 ]

    [ 2 ]   [ 3 ]

        [ 4 ]

    [ 5 ]   [ 6 ]

        [ 7 ]

    [ 8 ]   [ 9 ]

        [10]

        [11]
17 年運週期牌陣 

[ 1 ] [ 2 ] [ 3 ] [ 4 ]
[ 5 ] [ 6 ] [ 7 ] [ 8 ]
[ 9 ] [10 ] [11 ] [12 ]
導覽目錄