塔羅洗牌(舊版API,已暫停維護)

文件說明

         本API為早期塔羅占卜方案,主要用於兼容歷史接入系統,當前已暫停功能迭代與能力擴展,不再作為推薦API對外推廣。

         舊版API僅基於大阿爾克那牌進行抽牌與牌義輸出,解讀內容以單牌含義為主,未包含大小阿爾克那的整體體系,也不提供跨牌位、跨結構的綜合解讀分析能力。

         如用於正式產品、商業化場景或內容長期運營,強烈建議使用平臺最新提供的占卜 - 塔羅牌解讀 API。該API無需洗牌流程,覆蓋完整塔羅牌體系,並提供更加穩定、連貫的綜合解讀結果,適用於推薦系統、內容展示及會員制場景。

請求方式

POST GET

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

請求標頭 (Headers)

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

請求參數

欄位 型別 描述
api_key String 存取金鑰 (API Key)
taluo_spreads Int 塔羅牌陣 例:
2:二選一牌陣 3:聖三角|時光箭牌陣
4:四元素牌陣|戀人金字塔 5:五行牌陣|戀人牌陣|大十字牌陣
6:六芒星牌陣 7:七行星牌陣
8:複合牌陣 9:九宮格牌陣
注意:1~3 會返回9張牌號供使用者自行選擇;
4~9會返回19張牌號供使用者選擇;
選填參數,預設為1。
如果塔羅牌陣為1,使用者只需要抽選1張牌。
如果牌陣為2,使用者只需要抽選2張牌,以此類推。

請求參數範例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'taluo_spreads' => 2,
];

回傳參數

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

成功回傳範例

{
  "errcode": 0,
  "errmsg": "請求成功",
  "notice":"本次測算結果僅供娛樂使用,請勿用於封建迷信和違法用途。",
  "data": { //牌號
    "0": 21,  //牌號21
    "1": 10,  //牌號10
    "2": 14,  //牌號14
    "3": 2,
    "4": 15,
    "5": 8,
    "6": 13,
    "7": 1,
    "8": 3,
    "image": "https:\/\/yuanfenju.com\/Public\/img\/taluo\/back.jpg" //塔羅牌背部圖像
  }
}
                

失敗回傳範例

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