多牌阵占卜
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li> 塔罗牌，由“TAROT”一词音译而来，被称为“大自然的奥秘库”。它是西方古老的占卜工具，中世纪起流行于欧洲，其起源一直是个谜，此接口仅处理多牌阵占卜法，不考虑一张牌占卜的情况。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/divination/cards</code></p>
<h3>请求方式</h3>
<ul>
<li>POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间戳（毫秒数）</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，详见签名算法说明</td>
</tr>
<tr>
<td>taluoSpreads</td>
<td>Integer</td>
<td>是</td>
<td>塔罗牌阵 例：2：二选一牌阵 3：圣三角&#124;时光箭牌阵 4：四元素牌阵&#124;恋人金字塔 5：五行牌阵&#124;恋人牌阵&#124;大十字牌阵 6：六芒星牌阵 7：七行星牌阵 8：复合牌牌阵 9：九宫格牌阵</td>
</tr>
<tr>
<td>taluoUserChecked</td>
<td>String</td>
<td>是</td>
<td>用户已经选择的塔罗牌牌号列表，牌号列表应当以英文字符逗号分割，比如： 21,1,3,9 牌号列表内部元素数量要和塔罗牌阵编号匹配。可以通过塔罗-塔罗洗牌来获取卡牌编号。</td>
</tr>
<tr>
<td>lang</td>
<td>String</td>
<td>否</td>
<td>语言：zh-cn 、en-us 、zh-tw 默认：zh-cn </td>
</tr>
</tbody>
</table>
<h3>签名算法说明</h3>
<p><code>sign = sha256(appId + appSecret + timestamp)</code></p>
<p>用服务商分配的 appId、服务商分配的 appSecret，当前时间时间戳 timestamp，按上述顺序拼接成字符串，再进行 sha256 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>成功返回样例</h3>
<pre><code class="language-json">{
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,//code对应的描述
&quot;taskNo&quot;: &quot;589759658191944239234293&quot;,//本次请求号
&quot;charge&quot;: true,//计费标志
&quot;data&quot;: [{
&quot;position&quot;: &quot;第1号位牌信息&quot;, //将该牌信息放到牌阵第1号位
&quot;image&quot;: &quot;https://test-img2.anqkj.cn/divination/image/20250920/4d19ba009ca8449791d916f227ee1d5d.jpg&quot;, //塔罗牌图片
&quot;card_info&quot;: { //牌信息
&quot;cart_reverse&quot;: &quot;逆位&quot;, //牌位正逆
&quot;card_description&quot;: { //含义
&quot;base_desc&quot;: &quot;情绪低落、遭受失败、漫无目的的四处流浪、行为散漫、愚昧的行动。&quot;, //基本含义
&quot;love_marriage&quot;: &quot;心情空虚、轻率的恋情、无法长久持续的融洽感......&quot;, //恋爱婚姻
&quot;work_study&quot;: &quot;成绩一落千丈、没有耐心、行事缺乏计划、经常迟到......&quot;, //工作学业
&quot;inter_wealth&quot;: &quot;因过于单纯被他人轻视、被旁人视为怪胎、言行财......&quot;, //人际财富
&quot;health_life&quot;: &quot;不重视自身健康、生活不规律、因贪玩影响健康。&quot;, //健康生活
&quot;other&quot;: &quot;旅途中断、兴趣广泛、不脚踏实地、无视旁人眼光、冲动行事、行为不检点。&quot; //其他
&quot;advice&quot;: &quot;当愚人牌逆位出现时，它提醒你....&quot; //建议
&quot;love_marriage_advice&quot;: &quot;用温柔和坚定的态度来处理恋爱关系......&quot;, //恋爱婚姻建议
&quot;work_study_advice&quot;: &quot;大胆面对工作和学业中的挑战......&quot;, //工作学业建议
&quot;inter_wealth_advice&quot;: &quot;果断作出理智的投资和消费决策......&quot;, //人际财富建议
&quot;health_life_advice&quot;: &quot;保持活力和积极的生活态度....&quot;, //健康生活建议
},
&quot;card_name&quot;: &quot;愚人 The Fool&quot;, //牌名
&quot;card_keyword&quot;: &quot;开始、自由、天真、流浪、大胆、旅行&quot;, //关键字
&quot;card_astrology&quot;: &quot;天王星&quot;, //星相
&quot;card_elements&quot;: &quot;风&quot;, //四要素
&quot;card_summarize&quot;: &quot;愚人穿着色彩斑斓的服装，无....&quot; //牌面描述
}
}]
}</code></pre>
<h3>失败返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;塔罗牌阵不能为空&quot;,
&quot;code&quot;: 400
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，详见成功返回样例</td>
</tr>
</tbody>
</table>
<h3>code返回码说明</h3>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功（计费）</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>请求地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>服务商维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>607</td>
<td>ip不在白名单</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>