占卜-塔罗牌解读（新版接口）

文档说明

         本接口为平台最新推荐的塔罗占卜方案，基于 Rider–Waite 塔罗体系，并引入五行能量作为辅助语义维度。接口无需洗牌或抽牌流程，支持完整大小阿卡纳牌体系，并返回结构化解读结果，包括牌义、正逆位及综合解读分析，适用于内容展示、推荐系统及会员制场景。相较于旧版抽牌接口，本接口提供更加连贯、稳定的综合解读能力，并支持直接生成可用于前端展示或内容输出的结果。 非会员用户禁止访问。

接口使用说明

         1. 接口会自动完成抽牌逻辑，无需用户参与洗牌或选牌流程， 若需动画或交互效果，可由对接方自行实现界面表现。
         2. 接口返回的结果中包含塔罗牌图片访问地址（image_url）， 如需获取完整塔罗牌图片资料，可点击 此处 下载对应资源包。

请求方式

POST GET 

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

请求头

字段 类型 描述
Content-Type String application/x-www-form-urlencoded

请求参数

字段 类型 描述
api_key String 密钥
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 ]
汇总