塔羅洗牌(舊版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。
|
請求參數範例
$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": "日期有誤",
}