玄空飞星
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li>玄空飞星，其实是一种以理气为主的风水堪舆学说，这种风水学说讲究的是风水随着时间推移的变化，我们研究玄空风水，就是要根据这种变化去改造风水。注意：本接口返回数据的排飞星和排命盘各有9个数组，对应各自九宫。而排龙诀有12个数组，对应12宫。你画好宫图的时候，参考下面的图片将对应数组里的所有元素放在对应宫位即可。
[排飞星9宫对应数据示例图](<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/geomancy/reasoning/xuankong_feixing.jpg">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/geomancy/reasoning/xuankong_feixing.jpg</a> "排飞星9宫对应数据示例图") [排龙诀12宫对应数据示例图](<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/geomancy/reasoning/xuankong_longjue.jpg">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/geomancy/reasoning/xuankong_longjue.jpg</a> "排龙诀12宫对应数据示例图") [排命盘9宫对应数据示例图](<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/geomancy/reasoning/xuankong_mingpan.jpg">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/geomancy/reasoning/xuankong_mingpan.jpg</a> "排命盘9宫对应数据示例图")</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/geomancy/reasoning</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>bornYear</td>
<td>Integer</td>
<td>是</td>
<td>宅主出生农历年 例: 1988</td>
</tr>
<tr>
<td>sex</td>
<td>Integer</td>
<td>是</td>
<td>性别 0：男 1：女</td>
</tr>
<tr>
<td>yunModel</td>
<td>Integer</td>
<td>是</td>
<td>元运 例：0：一运 1：二运 2：三运 3：四运 4：五运 5：六运 6：七运 7：八运 8：九运</td>
</tr>
<tr>
<td>shanModel</td>
<td>Integer</td>
<td>是</td>
<td>山向 例： 0：壬山丙向 1：子山午向 2：癸山丁向 3：丑山未向 4：艮山坤向 5：寅山申向 6：甲山庚向 7：卯山酉向 8：乙山辛向 9：辰山戌向 10：巽山乾向 11：巳山亥向 12：丙山壬向 13：午山子向 14：丁山癸向 15：未山丑向 16：坤山艮向 17：申山寅向 18：庚山甲向 19：酉山卯向 20：辛山乙向 21：戌山辰向 22：乾山巽向 23：亥山巳向</td>
</tr>
<tr>
<td>tiModel</td>
<td>Integer</td>
<td>否</td>
<td>是否用替 例：0：否 1：是 默认：0</td>
</tr>
<tr>
<td>longModel</td>
<td>Integer</td>
<td>否</td>
<td>是否排龙诀 例：0：否 1：是 默认：0</td>
</tr>
<tr>
<td>longShuiKou</td>
<td>Integer</td>
<td>否</td>
<td>水口在 例：0：壬 1：子 2：癸 3：丑 4：艮 5：寅 6：甲 7：卯 8：乙 9：辰 10：巽 11：巳 12：丙 13：午 14：丁 15：未 16：坤 17：申 18：庚 19：酉 20：辛 21：戌 22：乾 23：亥 如果long_model 为1时，此选项择为必传 </td>
</tr>
<tr>
<td>mingModel</td>
<td>Integer</td>
<td>否</td>
<td>是否排命盘 例：0：否 1：是 默认：0 </td>
</tr>
<tr>
<td>mingLiuYear</td>
<td>Integer</td>
<td>否</td>
<td>农历流年 例：1990 如果 ming_model 为1时，此选项择为必传</td>
</tr>
<tr>
<td>mingLiuMonth</td>
<td>Integer</td>
<td>否</td>
<td>农历流月 例：8 如果 ming_model 为1时，此选项择为必传</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;297667220221147391480569&quot;,//本次请求号
&quot;charge&quot;: true,//计费标志
&quot;data&quot;: {
&quot;yuanyun&quot;: &quot;九运&quot;, //元运：九运
&quot;yuanyun_qizhi&quot;: &quot;2024年 至 2043年&quot;, //此九元运起止年为2024年 至 2043年
&quot;yongti&quot;: &quot;挨星替卦&quot;, //是否用替
&quot;shan&quot;: &quot;丑&quot;, //山
&quot;shanxiang&quot;: &quot;丑山未向&quot;, //山向：丑山未向
&quot;shuikou&quot;: &quot;丑&quot;, //水口在丑
&quot;minggua&quot;: &quot;艮八(西四命)&quot;, //命卦
&quot;simple_desc&quot;: &quot;宜出煞，楼门或大门宜开畅。而不宜收敛。开门宜大，或门旁边有较多玻璃窗，于室内于门处不宜有所阻拦，如设屏风等。且门外地势宜略低。&quot;, //简析
&quot;pan_info&quot;: {
&quot;feixing_gong&quot;: [ //排飞星-飞星宫盘0信息
{
&quot;shanpan&quot;: 6, //山盘信息(建议放在宫左上角，下同)
&quot;xiangpan&quot;: 1,//向盘信息(建议放在宫右上角，下同)
&quot;yunpan&quot;: &quot;五&quot;,//运盘信息(建议放在宫中部，下同)
&quot;dipan&quot;: &quot;坎一&quot;,//地盘信息(建议放在宫底部，下同)
//解析
&quot;feixing_desc&quot;: &quot;在吉利的日子里，当运势得以旺盛时，通常会带来喜悦、权力和官运等积极的变化。然而，如果运势失去平衡，则可能会引发负面的影响，如桃花运过旺、淫乱问题以及小产等不幸情况。为了充分利用吉日的好运，同时避免不利影响，建议在高兴之余保持理智和谨慎，关注身心健康，并妥善处理个人生活中的各种问题，以确保好运能带来真正的好处。&quot;
},
{ //排飞星-飞星宫盘1信息
&quot;shanpan&quot;: 4,
&quot;xiangpan&quot;: 3,
&quot;yunpan&quot;: &quot;三&quot;,
&quot;dipan&quot;: &quot;艮八&quot;,
&quot;feixing_desc&quot;: &quot;在不利的情况下，容易出现混乱和盗贼之事，导致财物损失或安全问题。此外，少女可能会面临精神方面的困扰或疾病。总的来说，这些不利因素提醒要注意保护财产和个人安全，同时关注年轻女性的心理健康，避免因运势不佳而造成更大的困扰或损害。&quot;
},
{ //排飞星-飞星宫盘2信息
&quot;shanpan&quot;: 8,
&quot;xiangpan&quot;: 8,
&quot;yunpan&quot;: &quot;七&quot;,
&quot;dipan&quot;: &quot;震三&quot;,
&quot;feixing_desc&quot;: &quot;在大吉的八运时期，运势极为有利。此时，地产投资将获得显著的成功，横财也会大幅增长。对少男特别有利，家庭中可能会多生男孩。然而，如果运势失去平衡，少男可能面临较高的风险。因此，在享受好运的同时，仍需注意安全和健康，尤其是对少男的保护，预防可能的意外或风险。&quot;
},
{ //排飞星-飞星宫盘3信息
&quot;shanpan&quot;: 9,
&quot;xiangpan&quot;: 7,
&quot;yunpan&quot;: &quot;八&quot;,
&quot;dipan&quot;: &quot;巽四&quot;,
&quot;feixing_desc&quot;: &quot;在九七穿途的时期，运势可能会带来一些麻烦。常常会出现回禄之灾，可能引发心病，导致财务难以积累，甚至经常破财。此外，对少女不利，可能会遇到健康问题。同时，这段时间也容易发生官司或口舌之争。因此，建议特别注意健康，控制财务支出，处理好人际关系，以尽量减少这些负面影响。&quot;
},
{ //排飞星-飞星宫盘4信息
&quot;shanpan&quot;: 5,
&quot;xiangpan&quot;: 2,
&quot;yunpan&quot;: &quot;四&quot;,
&quot;dipan&quot;: &quot;离九&quot;,
&quot;feixing_desc&quot;: &quot;在不利的情况下，可能会遇到多种健康问题和家庭困扰。例如，容易患上肠道疾病，手脚也容易受伤。此外，家庭中可能会出现寡妇，或者孕妇遭遇多种灾难，影响怀孕的安全和健康。整体上，家人可能会面临频繁的健康问题和不安定的状况。这些问题提示在这种运势下，需要特别注意健康保健，确保家庭成员的安全和稳定，尽量减少可能的病痛和困难。&quot;
},
{ //排飞星-飞星宫盘5信息
&quot;shanpan&quot;: 7,
&quot;xiangpan&quot;: 9,
&quot;yunpan&quot;: &quot;六&quot;,
&quot;dipan&quot;: &quot;坤二&quot;,
&quot;feixing_desc&quot;: &quot;在名为回禄之灾的时期，运势可能带来一些严重的问题。此时容易引发心脏病等健康问题，特别是对心脏的关注尤为重要。此外，这段时间可能使人变得聪明但刻薄，导致人际关系紧张。少女在这一时期也可能面临更多的伤灾。因此，建议在此期间特别注意心脏健康，保持良好的人际关系，并对少女多加照顾，防范潜在的安全风险。&quot;
},
{ //排飞星-飞星宫盘6信息
&quot;shanpan&quot;: 3,
&quot;xiangpan&quot;: 4,
&quot;yunpan&quot;: &quot;二&quot;,
&quot;dipan&quot;: &quot;兑七&quot;,
&quot;feixing_desc&quot;: &quot;当运势不佳或失运时，容易遇到桃花劫、遭遇盗贼，甚至家中的长女可能会生病或遭遇健康问题。然而，如果命运当令，则意味着在文职或学业上会有好消息，可能获得贵人的帮助，带来提升与成就，甚至获得名声与地位。这表明运势的好坏直接影响个人的生活状态：失运时多有烦恼，而得令时则会有好运临门，尤其在事业和名誉方面。&quot;
},
{ //排飞星-飞星宫盘7信息
&quot;shanpan&quot;: 2,
&quot;xiangpan&quot;: 5,
&quot;yunpan&quot;: &quot;一&quot;,
&quot;dipan&quot;: &quot;乾六&quot;,
&quot;feixing_desc&quot;: &quot;当二黑与五黄交加时，往往会带来一些严重的问题，包括损害家庭主人的健康，导致孤寡之人或家庭成员健康状况较差，特别是母亲多病。这种组合还可能引发各种伤病，影响家庭的整体健康。《紫白诀》进一步指出，二黑主宅的母亲容易多病，而当黑色与黄色相遇时，也可能导致家庭中出现鳏夫。这提醒在这种情况下需要特别注意家庭成员的健康，尽量避免可能的健康问题和不幸的发生。&quot;
},
{ //排飞星-飞星宫盘8信息
&quot;shanpan&quot;: 1,
&quot;xiangpan&quot;: 6,
&quot;yunpan&quot;: &quot;九&quot;,
&quot;dipan&quot;: &quot;中五&quot;,
&quot;feixing_desc&quot;: &quot;在运中，能够获得武职的贵人运势，预示着事业发展顺利，生活如意，吉祥顺利。尤其是在与武职相关的领域或生活方面，能够取得较大的成就和好运。此外，文职方面也有喜事临门，预示着学业或文书工作会有成功的机会和喜悦。然而，尽管这些方面都充满了吉祥和顺遂的迹象，但同时也需要警惕潜在的烂桃花问题。这意味着，在享受生活中的好运与成就时，要注意控制自己的行为，以免因过度放纵而带来不良的后果。&quot;
}
],
//排龙诀(只有long_model为1时，才有此longjue_gong数据)
&quot;longjue_gong&quot;: [ //排龙诀-龙诀宫盘0信息
{
&quot;xingyaopan&quot;: &quot;禄存&quot;, //星曜盘信息(建议放在宫上部，下同。另：左辅、贪狼、武曲、巨门、右弼此为五吉。破军、廉贞、文曲、禄存为四凶，可以考虑颜色区分吉凶星。)
&quot;dipan&quot;: &quot;子癸&quot; //地盘信息(建议放在宫底部，下同)
},
{ //排龙诀-龙诀宫盘1信息
&quot;xingyaopan&quot;: &quot;破军&quot;,
&quot;dipan&quot;: &quot;丑艮&quot;
},
{ //排龙诀-龙诀宫盘2信息
&quot;xingyaopan&quot;: &quot;右弼&quot;,
&quot;dipan&quot;: &quot;寅甲&quot;
},
{ //排龙诀-龙诀宫盘3信息
&quot;xingyaopan&quot;: &quot;廉贞&quot;,
&quot;dipan&quot;: &quot;卯乙&quot;
},
{ //排龙诀-龙诀宫盘4信息
&quot;xingyaopan&quot;: &quot;破军&quot;,
&quot;dipan&quot;: &quot;辰巽&quot;
},
{ //排龙诀-龙诀宫盘5信息
&quot;xingyaopan&quot;: &quot;武曲&quot;,
&quot;dipan&quot;: &quot;巳丙&quot;
},
{ //排龙诀-龙诀宫盘6信息
&quot;xingyaopan&quot;: &quot;贪狼&quot;,
&quot;dipan&quot;: &quot;午丁&quot;
},
{ //排龙诀-龙诀宫盘7信息
&quot;xingyaopan&quot;: &quot;破军&quot;,
&quot;dipan&quot;: &quot;未坤&quot;
},
{ //排龙诀-龙诀宫盘8信息
&quot;xingyaopan&quot;: &quot;左辅&quot;,
&quot;dipan&quot;: &quot;申庚&quot;
},
{ //排龙诀-龙诀宫盘9信息
&quot;xingyaopan&quot;: &quot;文曲&quot;,
&quot;dipan&quot;: &quot;酉辛&quot;
},
{ //排龙诀-龙诀宫盘10信息
&quot;xingyaopan&quot;: &quot;破军&quot;,
&quot;dipan&quot;: &quot;戌乾&quot;
},
{ //排龙诀-龙诀宫盘11信息
&quot;xingyaopan&quot;: &quot;巨门&quot;,
&quot;dipan&quot;: &quot;亥壬&quot;
}
],
//排命盘(只有ming_model为1时，才有此mingpan_gong数据)
&quot;mingpan_gong&quot;: [//排命盘-命盘宫0信息
{
&quot;nianpan&quot;: &quot;8&quot;,//流年盘信息(建议放在宫左上角，下同)
&quot;yuepan&quot;: &quot;3&quot;, //流月盘信息(建议放在宫右上角，下同)
&quot;mingpan&quot;: &quot;五&quot; //命盘信息(建议放在宫中部，下同)
},
{ //排命盘-命盘宫1信息
&quot;nianpan&quot;: &quot;6&quot;,
&quot;yuepan&quot;: &quot;1&quot;,
&quot;mingpan&quot;: &quot;三&quot;
},
{ //排命盘-命盘宫2信息
&quot;nianpan&quot;: &quot;1&quot;,
&quot;yuepan&quot;: &quot;5&quot;,
&quot;mingpan&quot;: &quot;七&quot;
},
{ //排命盘-命盘宫3信息
&quot;nianpan&quot;: &quot;2&quot;,
&quot;yuepan&quot;: &quot;6&quot;,
&quot;mingpan&quot;: &quot;八&quot;
},
{ //排命盘-命盘宫4信息
&quot;nianpan&quot;: &quot;7&quot;,
&quot;yuepan&quot;: &quot;2&quot;,
&quot;mingpan&quot;: &quot;四&quot;
},
{ //排命盘-命盘宫5信息
&quot;nianpan&quot;: &quot;9&quot;,
&quot;yuepan&quot;: &quot;4&quot;,
&quot;mingpan&quot;: &quot;六&quot;
},
{ //排命盘-命盘宫6信息
&quot;nianpan&quot;: &quot;5&quot;,
&quot;yuepan&quot;: &quot;9&quot;,
&quot;mingpan&quot;: &quot;二&quot;
},
{ //排命盘-命盘宫7信息
&quot;nianpan&quot;: &quot;4&quot;,
&quot;yuepan&quot;: &quot;8&quot;,
&quot;mingpan&quot;: &quot;一&quot;
},
{ //排命盘-命盘宫8信息
&quot;nianpan&quot;: &quot;3&quot;,
&quot;yuepan&quot;: &quot;7&quot;,
&quot;mingpan&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>