大六壬排盘
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li>大六壬为古老术数，与奇门、太乙并称三式。其排盘依据占时等起课，经天地盘、四课、三传等呈现信息。并参考《御定六壬直指》用以助解大六壬奥秘 。</li>
<li>注意：大六壬排盘重点是三个部分：1.天地神盘(gong_pan 12个数组) 2.四课盘(sike_info 4个数组) 3.三传盘(sanchuan_info 3个数组)：
对于天地神盘，需要先画好12宫图，然后将对应数组里的所有元素放在对应宫位即可。
对于四课盘，从左到右列 0～3 的数组，数组内容从上到下排即可。
对于三传盘，从上到下列 0～2 的数组，数组内容从左到右排即可。
[大六壬天地神盘对应数据示例图](<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/daliuren_gongpan.png">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/daliuren_gongpan.png</a> "大六壬天地神盘对应数据示例图")
[大六壬四课盘对应数据示例图](<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/daliuren_sike.png">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/daliuren_sike.png</a> "大六壬四课盘对应数据示例图")
[大六壬三传盘对应数据示例图](<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/daliuren_sanchuan.png">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/daliuren_sanchuan.png</a> "大六壬三传盘对应数据示例图")</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/fortune/great/liuren</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>name</td>
<td>String</td>
<td>是</td>
<td>姓名</td>
</tr>
<tr>
<td>sex</td>
<td>Integer</td>
<td>是</td>
<td>性别 0：男 1：女</td>
</tr>
<tr>
<td>type</td>
<td>Integer</td>
<td>是</td>
<td>历类型 0：农历 1：公历</td>
</tr>
<tr>
<td>bornYear</td>
<td>Integer</td>
<td>是</td>
<td>出生年 例: 1988</td>
</tr>
<tr>
<td>year</td>
<td>Integer</td>
<td>是</td>
<td>起盘年 例: 1988</td>
</tr>
<tr>
<td>month</td>
<td>Integer</td>
<td>是</td>
<td>起盘月 例: 8</td>
</tr>
<tr>
<td>day</td>
<td>Integer</td>
<td>是</td>
<td>起盘日 例: 7</td>
</tr>
<tr>
<td>hours</td>
<td>Integer</td>
<td>是</td>
<td>起盘时 例: 12</td>
</tr>
<tr>
<td>minute</td>
<td>Integer</td>
<td>是</td>
<td>起盘分 例: 30 如果不知道具体分，可以传数字 0</td>
</tr>
<tr>
<td>guiModel</td>
<td>Integer</td>
<td>否</td>
<td>贵人方式 0：甲羊戊庚牛 1：甲戊庚牛羊 默认：1</td>
</tr>
<tr>
<td>guiXingModel</td>
<td>Integer</td>
<td>否</td>
<td>贵人行运 0：夜 1：昼 2：自动 默认：2 </td>
</tr>
<tr>
<td>peiModel</td>
<td>Integer</td>
<td>否</td>
<td>三传配干 0：日旬遁干 1：时旬遁干 默认：0 </td>
</tr>
<tr>
<td>hangYear</td>
<td>Integer</td>
<td>否</td>
<td>是否排行年 0：否 1：是 默认：0</td>
</tr>
<tr>
<td>zhen</td>
<td>Integer</td>
<td>否</td>
<td>是否真太阳时 1：考虑真太阳时 2：不考虑真太阳时 默认：2</td>
</tr>
<tr>
<td>province</td>
<td>String</td>
<td>是</td>
<td>省 例：北京市 如果考虑真太阳时，省和市都必传 详见<a href="<a href="https://www.showdoc.com.cn/jumdata/11558915168150800">真太阳时城市列表</a>">https://www.showdoc.com.cn/jumdata/11558915168150800">真太阳时城市列表</a></a>; </td>
</tr>
<tr>
<td>city</td>
<td>String</td>
<td>是</td>
<td>市 例：北京 如果考虑真太阳时，省和市都必传 详见<a href="<a href="https://www.showdoc.com.cn/jumdata/11558915168150800">真太阳时城市列表</a>">https://www.showdoc.com.cn/jumdata/11558915168150800">真太阳时城市列表</a></a>; </td>
</tr>
<tr>
<td>lang</td>
<td>String</td>
<td>否</td>
<td>语言：zh-cn 、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;949021972156023005685455&quot;,//本次请求号
&quot;charge&quot;: true,//计费标志
&quot;data&quot;: {
&quot;name&quot;: &quot;张三&quot;,
&quot;sex&quot;: &quot;乾造&quot;,
&quot;gongli&quot;: &quot;2024年03月30日09时45分&quot;, //公历起盘时间
&quot;nongli&quot;: &quot;2024年二月廿一日巳时&quot;, //农历起盘时间
&quot;jieqi&quot;: &quot;2024年03月20日11时06分春分&quot;, //节气
&quot;sizhu_info&quot;: { //四柱信息
&quot;year_gan&quot;: &quot;甲&quot;, //年干
&quot;year_zhi&quot;: &quot;辰&quot;, //年支
&quot;month_gan&quot;: &quot;丁&quot;, //月干
&quot;month_zhi&quot;: &quot;卯&quot;, //月支
&quot;day_gan&quot;: &quot;癸&quot;, //日干
&quot;day_zhi&quot;: &quot;巳&quot;, //日支
&quot;hour_gan&quot;: &quot;丁&quot;, //时干
&quot;hour_zhi&quot;: &quot;巳&quot; //时支
},
&quot;xunkong_info&quot;: { //旬空信息
&quot;year_xunkong&quot;: &quot;寅卯&quot;, //年柱旬空
&quot;month_xunkong&quot;: &quot;亥戌&quot;,//月柱旬空
&quot;day_xunkong&quot;: &quot;午未&quot;, //日柱旬空
&quot;hour_xunkong&quot;: &quot;子丑&quot; //时柱旬空
},
&quot;yuejiang&quot;: &quot;戌将&quot;, //月将
&quot;hangnian&quot;: &quot;乙巳&quot;, //行年，只有 hang_year 为1时 这里才有值，否则只有 &quot;--&quot;
&quot;nianming&quot;: &quot;庚午&quot;, //年命，只有 hang_year 为1时 这里才有值，否则只有 &quot;--&quot;
&quot;gong_pan&quot;: [ //天地神盘12宫盘信息 下标从0～11 有12个数组
{
&quot;shenpan&quot;: &quot;天后&quot;, //第1宫神盘
&quot;tianpan&quot;: &quot;辰&quot;, //第1宫天盘
&quot;dipan&quot;: &quot;亥宫&quot; //第1宫地盘
},
{
&quot;shenpan&quot;: &quot;贵人&quot;, //第2宫神盘
&quot;tianpan&quot;: &quot;巳&quot;, //第2宫天盘
&quot;dipan&quot;: &quot;子宫&quot; //第2宫地盘
},
{
&quot;shenpan&quot;: &quot;螣蛇&quot;,
&quot;tianpan&quot;: &quot;午&quot;,
&quot;dipan&quot;: &quot;丑宫&quot;
},
{
&quot;shenpan&quot;: &quot;朱雀&quot;,
&quot;tianpan&quot;: &quot;未&quot;,
&quot;dipan&quot;: &quot;寅宫&quot;
},
{
&quot;shenpan&quot;: &quot;六合&quot;,
&quot;tianpan&quot;: &quot;申&quot;,
&quot;dipan&quot;: &quot;卯宫&quot;
},
{
&quot;shenpan&quot;: &quot;勾陈&quot;,
&quot;tianpan&quot;: &quot;酉&quot;,
&quot;dipan&quot;: &quot;辰宫&quot;
},
{
&quot;shenpan&quot;: &quot;青龙&quot;,
&quot;tianpan&quot;: &quot;戌&quot;,
&quot;dipan&quot;: &quot;巳宫&quot;
},
{
&quot;shenpan&quot;: &quot;天空&quot;,
&quot;tianpan&quot;: &quot;亥&quot;,
&quot;dipan&quot;: &quot;午宫&quot;
},
{
&quot;shenpan&quot;: &quot;白虎&quot;,
&quot;tianpan&quot;: &quot;子&quot;,
&quot;dipan&quot;: &quot;未宫&quot;
},
{
&quot;shenpan&quot;: &quot;太常&quot;,
&quot;tianpan&quot;: &quot;丑&quot;,
&quot;dipan&quot;: &quot;申宫&quot;
},
{
&quot;shenpan&quot;: &quot;玄武&quot;,
&quot;tianpan&quot;: &quot;寅&quot;,
&quot;dipan&quot;: &quot;酉宫&quot;
},
{
&quot;shenpan&quot;: &quot;太阴&quot;, //第12宫神盘
&quot;tianpan&quot;: &quot;卯&quot;, //第12宫天盘
&quot;dipan&quot;: &quot;戌宫&quot; //第12宫地盘
}
],
&quot;sike_info&quot;: [ //四课盘信息 下标从 0～3 有四个数组
{
&quot;guishen&quot;: &quot;太阴&quot;, //第1个四课贵神
&quot;sike&quot;: &quot;卯&quot;, //第1个四课内容
&quot;xunke&quot;: &quot;戌&quot; //第1个四课循课
},
{
&quot;guishen&quot;: &quot;青龙&quot;,//第2个四课贵神
&quot;sike&quot;: &quot;戌&quot;, //第2个四课内容
&quot;xunke&quot;: &quot;巳&quot; //第2个四课循课
},
{
&quot;guishen&quot;: &quot;天空&quot;, //第3个四课贵神
&quot;sike&quot;: &quot;亥&quot;, //第3个四课内容
&quot;xunke&quot;: &quot;午&quot; //第3个四课循课
},
{
&quot;guishen&quot;: &quot;螣蛇&quot;, //第4个四课贵神
&quot;sike&quot;: &quot;午&quot;, //第4个四课内容
&quot;xunke&quot;: &quot;癸&quot; //第4个四课循课
}
],
&quot;sanchuan_info&quot;: [ //三传盘信息 下标从0～2 有三个数组
{
&quot;sanchuan_biaoshi&quot;: &quot;初传&quot;, //第1个三传标识
&quot;sanchuan_liuqin&quot;: &quot;妻财&quot;, //第1个三传六亲
&quot;sanchuan_ganzhi&quot;: &quot;--午&quot;, //第1个三传干支
&quot;sanchuan_guishen&quot;: &quot;螣蛇&quot; //第1个三传贵神
},
{
&quot;sanchuan_biaoshi&quot;: &quot;中传&quot;, //第2个三传标识
&quot;sanchuan_liuqin&quot;: &quot;兄弟&quot;, //第2个三传六亲
&quot;sanchuan_ganzhi&quot;: &quot;丁亥&quot;, //第2个三传干支
&quot;sanchuan_guishen&quot;: &quot;天空&quot; //第2个三传贵神
},
{
&quot;sanchuan_biaoshi&quot;: &quot;末传&quot;, //第3个三传标识
&quot;sanchuan_liuqin&quot;: &quot;官鬼&quot;, //第3个三传六亲
&quot;sanchuan_ganzhi&quot;: &quot;壬辰&quot;, //第3个三传干支
&quot;sanchuan_guishen&quot;: &quot;天后&quot; //第3个三传贵神
}
],
//大六壬解析
&quot;daliuren_desc&quot;: {
//课体
&quot;keti&quot;: &quot;重审，斫轮。&quot;,
//课义
&quot;keyi&quot;: &quot;交朋合美，财神已矣，生虎鬼龙，一悲一喜。&quot;,
//解曰
&quot;jieyue&quot;: &quot;地支上的子水，与天干的丑土相合；天干上的申金，又与地支的巳火相合，上下交互相合，意味着朋友之间的情谊自然和美。然而，巳火作为癸水的财神，既被旺盛的禄神所克制，又被戌土所代表的白虎星归入墓库，因此这财宜果断舍弃。在夜晚占测时，申金本可生扶自身，却乘临白虎，带来凶煞之气；戌土本是克制日干的官鬼，却乘临青龙，象征着喜庆之事。如此一来，吉凶参半，悲喜交加 。&quot;,
//断曰
&quot;duanyue&quot;: &quot;此为斫轮之卦，对于占问官职极为有利。但在白天占测时，贵人落入狱中，这种情况下不宜贸然求见当权者，以免触犯忌讳。同时，旺盛的禄神降临于地支并克制地支，暗示宅中不太安稳。若能通过一些喜事来进行破耗，以此冲抵不利，那么反而能够获得吉祥 。&quot;,
//天气
&quot;tianqi&quot;: &quot;水母临于天干，青龙临于地支，且天罡指向毕宿，种种迹象表明必然会有降雨。从气象角度来看，水母象征着水汽，青龙主生气，两者相遇，加上毕宿的特殊寓意，预示着天空中水汽充足，云层聚集，即将迎来降雨天气。在降雨来临前，人们要做好防雨准备，如关闭门窗、收好室外物品等。对于农业生产来说，降雨能滋润土地，促进农作物生长，但也要注意防范洪涝灾害对庄稼的损害 。&quot;,
//谋事
&quot;moushi&quot;: &quot;在此课象下谋划事情，朋友之间的合作较为顺利，彼此关系融洽，能够相互支持。但在涉及财运方面，需要谨慎行事，原有的财路可能受阻，不应过度执着。要善于发现新的机遇，就像在困境中寻找突破口。比如在创业过程中，虽然合作伙伴可靠，但资金方面可能会遇到困难，这时需要灵活调整策略，寻找新的投资渠道或盈利方式。在做事过程中，会遇到一些看似矛盾的情况，如同生虎鬼龙般一悲一喜，需要冷静分析，权衡利弊，才能做出正确的决策 。&quot;,
//家宅
&quot;jiazhai&quot;: &quot;家中会有诸多喜合之事，如家人团聚、朋友来访等，家庭氛围和谐融洽。然而，也要注意禄神克支带来的影响，可能会出现一些小的波折，如家庭物品损坏、成员之间的小摩擦等。可以通过举办家庭聚会、进行家居装饰等方式，增强家庭的凝聚力，化解潜在的不利因素。同时，要关注家庭成员的健康和情绪，及时沟通交流，确保家庭的稳定和幸福 。&quot;,
//婚姻
&quot;hunyin&quot;: &quot;男女双方交车相合，意味着婚姻关系能够和谐美满，如同秦晋两国联姻般顺遂。在婚姻生活中，夫妻双方能够相互理解、包容，共同面对生活中的困难和挑战。在选择伴侣时，双方的契合度较高，感情发展较为顺利。但在婚后，也需要不断维护和经营婚姻关系，多沟通交流，保持彼此之间的新鲜感和爱意，让婚姻更加长久幸福 。&quot;,
//疾病
&quot;jibing&quot;: &quot;可能会患上伤风、肾竭等病症，不过幸运的是，能够得到医术高明的医生的治疗，不久之后便可痊愈。在患病期间，患者要积极配合医生的治疗方案，按时服药，注意休息，保持良好的生活习惯。同时，要保持乐观的心态，相信身体能够逐渐恢复健康。在饮食方面，要注意营养均衡，避免食用辛辣、油腻等刺激性食物，以促进身体的康复 。&quot;,
//怀孕
&quot;huaiyun&quot;: &quot;若是私胎，预示着会生男孩，但距离产期还有一段时间。在孕期，孕妇要注意自身的身体状况，定期进行产检，遵循医生的建议，确保胎儿的健康发育。家人也要给予孕妇足够的关怀和照顾，为孕妇创造一个舒适、安心的孕育环境。在日常生活中，孕妇要避免剧烈运动，保持心情舒畅，合理饮食，为胎儿的成长提供良好的条件 。&quot;,
//求财
&quot;qiucai&quot;: &quot;虽然财爻有所显现，但获取财富的过程可能会引发一些隐患。在求财时，要谨慎行事，不要盲目冒险，避免因贪图小利而遭受损失。可以通过稳健的投资、合理的理财规划等方式，逐步积累财富。同时，要注意与合作伙伴的关系，避免因利益分配不均而产生矛盾。在面对财富机遇时，要冷静分析，权衡利弊，确保求财行为的安全性和可持续性 。&quot;,
//寻人
&quot;xunren&quot;: &quot;寻找失踪之人时，可从其人际关系入手，询问与失踪者关系密切的朋友、家人，了解他们是否知道失踪者的去向。同时，查看失踪者常去的地方，如工作场所、社交场所等。需要广泛收集信息，借助社交媒体、张贴寻人启事等方式扩大寻找范围。在寻找过程中，要保持耐心和信心，持续努力，才有可能找到失踪之人 。&quot;,
//失物
&quot;shiwu&quot;: &quot;若物品丢失，可先回忆物品最后出现的位置，然后从这个位置开始，仔细在家中寻找。检查房间的各个角落、抽屉、衣柜等地方，也可以询问家人是否见过。如果在家里没有找到，可以考虑在住宅周边寻找，如楼道、院子等地方。因为课象中暗示物品可能未离开家宅附近，只要认真寻找，找回失物的可能性较大 。&quot;,
//行人
&quot;xingren&quot;: &quot;天罡加于仲位，表明行人尚在行程中途。可能由于路途较远、事务耽搁等原因，导致行程有所延迟。可以通过与行人保持联系，了解他们的具体位置和行程安排，以便做好迎接或后续安排的准备。如果行人有重要的事情需要处理，要及时沟通协调，确保事情能够顺利进行 。&quot;,
//出行
&quot;chuxing&quot;: &quot;无论是选择水路还是陆路出行，都较为适宜。在出行过程中，可能会遇到一些机遇，如结识有趣的人、发现新的风景等，让旅途更加丰富多彩。但也要注意行人恋宅，可能会导致行期有所迟滞。在出行前，要做好充分的准备，规划好行程，预留足够的时间应对突发情况。同时，要注意安全，保管好个人财物，确保旅途顺利 。&quot;
},
&quot;zhen&quot;: { //考虑真太阳时才会有此字段，不考虑真太阳时就没有这个字段
&quot;province&quot;: &quot;北京市&quot;, //真太阳时省
&quot;city&quot;: &quot;北京&quot;, //真太阳时市
&quot;jingdu&quot;: &quot;116.46&quot;, //真太阳经度
&quot;weidu&quot;: &quot;39.92&quot;, //真太阳纬度
&quot;shicha&quot;: &quot;晚0小时14分10秒&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>