梅花易数
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li>什么是梅花易数：梅花易数为北宋易学家邵雍所传，因观梅知易数而得名。以卦象生克为主，而不分析爻象。是为梅花易数预测。</li>
<li>注意：梅花易数有【本卦】、【互卦】、【变卦】、【错卦】、【综卦】五大类。一般非专业人士只看【本卦】、【互卦】和【变卦】。每个卦由六爻组成，从下到上依次为初爻、二爻、三爻、四爻、五爻、六爻。每个爻分为阴爻（断线 "--"）和阳爻（横线 "-"）。为了方便表示，本接口返回参数中的gua_mark包含了爻信息，仅由0和1元素组成六位数字符串。例如，gua_mark="010111"，从左到右依次为阴爻、阳爻、阴爻、阳爻、阳爻、阳爻；按此顺序排卦，从下往上排，初爻为阴 "--"，二爻为阳 "-"，三爻为阴 "--"，四爻为阳 "-"，五爻为阳 "-"，六爻为阳 "-"，最终卦图如下所示：[最终卦图](<a href="https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/gossip-prediction_demo.jpg">https://anq-file.oss-cn-hangzhou.aliyuncs.com/api-document/fortune/gossip-prediction_demo.jpg</a> "最终卦图")</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/fortune/mathematics</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>sex</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>panModel</td>
<td>Integer</td>
<td>是</td>
<td>起卦方式，1：自动起卦 2：自选时间 3：终身卦 4：手工指定 5：数字起卦 6：单数起卦 7：双数起卦 </td>
</tr>
<tr>
<td>yaoAddTime</td>
<td>Integer</td>
<td>否</td>
<td>动爻是否加时辰，0：否 1：是 非必传，如果不传递这个参数，默认0，另外此参数仅在panModel为5,6,7时有效</td>
</tr>
<tr>
<td>year</td>
<td>Integer</td>
<td>否</td>
<td>公历起盘年 例: 1988，如果 panModel 为2,3时，此参数为必传。</td>
</tr>
<tr>
<td>month</td>
<td>Integer</td>
<td>否</td>
<td>公历起盘月 例: 8，如果 panModel 为2,3时，此参数为必传。</td>
</tr>
<tr>
<td>day</td>
<td>Integer</td>
<td>否</td>
<td>公历起盘日 例: 7 ，如果 panModel 为2,3时，此参数为必传。</td>
</tr>
<tr>
<td>hours</td>
<td>Integer</td>
<td>否</td>
<td>公历起盘时 例: 12，如果 panModel 为2,3时，此参数为必传。</td>
</tr>
<tr>
<td>minute</td>
<td>Integer</td>
<td>否</td>
<td>公历起盘分 例: 30 ，如果 panModel 为2,3时，此参数为必传。</td>
</tr>
<tr>
<td>guaYao1</td>
<td>Integer</td>
<td>否</td>
<td>手工指定初爻参数，0：少阴 1：少阳 2：老阴 3：老阳，panModel为4时，必传</td>
</tr>
<tr>
<td>guaYao2</td>
<td>Integer</td>
<td>否</td>
<td>手工指定二爻参数，0：少阴 1：少阳 2：老阴 3：老阳，panModel为4时，必传 </td>
</tr>
<tr>
<td>guaYao3</td>
<td>Integer</td>
<td>否</td>
<td>手工指定三爻参数，0：少阴 1：少阳 2：老阴 3：老阳，panModel为4时，必传</td>
</tr>
<tr>
<td>guaYao4</td>
<td>Integer</td>
<td>否</td>
<td>手工指定四爻参数，0：少阴 1：少阳 2：老阴 3：老阳，panModel为4时，必传</td>
</tr>
<tr>
<td>guaYao5</td>
<td>Integer</td>
<td>否</td>
<td>手工指定五爻参数，0：少阴 1：少阳 2：老阴 3：老阳，panModel为4时，必传</td>
</tr>
<tr>
<td>guaYao6</td>
<td>Integer</td>
<td>否</td>
<td>手工指定六爻参数，0：少阴 1：少阳 2：老阴 3：老阳，panModel为4时，必传</td>
</tr>
<tr>
<td>number</td>
<td>Integer</td>
<td>否</td>
<td>指定整数数字，例:30，panModel为5,6时，必传</td>
</tr>
<tr>
<td>numberUp</td>
<td>Integer</td>
<td>否</td>
<td>指定上卦数字，例:2，panModel为7时，必传</td>
</tr>
<tr>
<td>numberDown</td>
<td>Integer</td>
<td>否</td>
<td>指定下卦数字，例:30，panModel为7时，必传</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;949021972156023005685455&quot;,//本次请求号
&quot;charge&quot;: true,//计费标志
&quot;data&quot;: {
&quot;sex&quot;: &quot;男&quot;,
&quot;model&quot;: &quot;手工起卦&quot;, //起卦方式
&quot;gongli&quot;: &quot;2024-06-23 17:06:00&quot;, //公历时间
&quot;nongli&quot;: &quot;二〇二四年五月十八日 酉时&quot;,//农历时间
&quot;nianming&quot;: &quot;己卯&quot;, //年命
&quot;has_biangua&quot;: &quot;0&quot;, //是否有变卦，例：1.代表有变卦信息 0.代表没有变卦信息
&quot;dongyao&quot;: &quot;0&quot;, //动爻位，如果为0则代表没有动爻。如果非0则由数字1～6通过逗号分隔的字符串组成(元素总数不会超过6个)，例如，&quot;1&quot; 表示初爻动。例如，&quot;5,6&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;gua_info&quot;: { //卦信息
&quot;bengua&quot;: { //【本卦】信息-永远会有值
&quot;gua_mark&quot;: &quot;010001&quot;, //卦图标记，0代表阴爻，1代表阳爻，
&quot;gua_name&quot;: &quot;山水蒙&quot;, //卦命
&quot;gua_qian&quot;: &quot;卦中爻象犯小耗，君子占之运不高，婚姻合伙有琐碎，做事必然受苦劳。&quot;, //卦签
&quot;gua_qian_desc&quot;: &quot;异卦(下坎上艮)相叠，艮是山的形象，喻止；坎是水的形象，喻险。卦形为山下有险，仍不停止前进，是为蒙昧，故称蒙卦。但因把握时机，行动切合时宜，因此，具有启蒙和通达的卦象。&quot;, //解卦
&quot;gua_yaoci&quot;: &quot;蒙：亨。匪我求童蒙，童蒙求我。初噬告，再三渎，渎则不告。利贞。彖曰：蒙，山下有险，险而止，蒙。蒙亨，以亨行时中也。匪我求童蒙，童蒙求我......&quot;, //爻辞
&quot;gua_description&quot;: { //占事结果
//事业
&quot;gua_shiye&quot;: &quot;事业开始，混乱无序，危机四伏，以勇敢坚毅的行动可以扭转局面。然而必须接受严格教育，培养这种奋发图强的精神。务必脚踏实地，最忌好高骛远，否则会陷入孤立无援的境地。&quot;,
//经商
&quot;gua_jingshang&quot;: &quot;务必小心谨慎，不得急功近利，尤其应树立高尚的商业道德，以良好的信誉提高竞争力而取胜。&quot;,
//求名
&quot;gua_qiuming&quot;: &quot;必须接受良好的基础教育，陶冶情操。且动机纯正，可以达到目的。&quot;,
//外出
&quot;gua_waichu&quot;: &quot;等候有利时机再行动，等待期间应积极做准备。&quot;,
//婚恋
&quot;gua_hunlian&quot;: &quot;注意考察对方品德，不可以金钱为诱铒。夫妻需相互宽容、理解。&quot;,
//决策
&quot;gua_juece&quot;: &quot;有时会陷入迷惘困顿的境地，加上胆小、不果断，往往误事。如能接受长辈的教诲，甚至严酷的考验，抛弃疑惧的心理，等待适当时机，必然一帆风顺。&quot;
},
&quot;gua_xiongji&quot;: &quot;中下卦&quot; //卦的吉凶
},
&quot;hugua&quot;: { //【互卦】信息-永远会有值
&quot;gua_mark&quot;: &quot;100000&quot;,
&quot;gua_name&quot;: &quot;地雷复&quot;,
&quot;gua_qian&quot;: &quot;马氏太公不相合，世人占之忧疑多，恩人无义反为怨，是非平地起风波。&quot;,
&quot;gua_qian_desc&quot;: &quot;异卦(下震上坤)相叠。震为雷、为动；坤为地、为顺，动则顺，顺其自然。动在顺中，内阳外阴，循序运动，进退自如，利于前进。&quot;,
&quot;gua_yaoci&quot;: &quot;复：亨。出入无疾，朋来无咎。反复其道，七日来复，利有攸往。彖曰：复亨；刚反，动而以顺行，是以出入无疾，朋来无咎。反复其道，七日来复，天行也。利有攸往，刚长也。复其见天地之心乎？象曰：雷在地中，复；先王以至日闭关，商旅不行，后不省方。初九：不复远，无只悔，元吉。象曰：不远之复，以修身也。六二：休复，吉。象曰：休复之吉，以下仁也。六三：频复，厉无咎。象曰：频复之厉，义无咎也。六四：中行独复。象曰：中行独复，以从道也。六五：敦复，无悔。象曰：敦复无悔，中以自考也。上六：迷复，凶，有灾眚。用行师，终有大败，以其国君，凶；至于十年，不克征。象曰：迷复之凶，反君道也。&quot;,
&quot;gua_description&quot;: {
&quot;gua_shiye&quot;: &quot;已经渡过了困难时期，开始进入积极行动的阶段。但务必抓住时机，当机立断，却不可急躁，且应时常反省个人行动，严于修身，勇往直前，可望成功。&quot;,
&quot;gua_jingshang&quot;: &quot;可大胆投资，与志同道合的伙伴坦诚合作，打开市场，勿因挫折而退缩。更可以打入外地，坚持商业道德，循序渐进，一定会有所赢利。&quot;,
&quot;gua_qiuming&quot;: &quot;时机正在成熟，不要急于求成，继续奠定基础，机遇一旦到来，务必要抓住，必将转运。最忌自伤意志。&quot;,
&quot;gua_waichu&quot;: &quot;无灾无祸，且有收获。&quot;,
&quot;gua_hunlian&quot;: &quot;顺利。但切不可性急，应冷静考虑。家庭的美满幸福，靠严于律己维持。&quot;,
&quot;gua_juece&quot;: &quot;性格活泼，精力旺盛，但因急躁情绪会造成事业损失。一定要冷静思考，勇于改正错误，必能重振事业。此时应抓住时机，明确方向，灵活机敏，脚踏实地改变处境。一旦出现意外，宜当机立断，暂行退让。如能准确驾驶自己，努力奋斗，成就事业十分顺利。&quot;
},
&quot;gua_xiongji&quot;: &quot;中中卦&quot;
},
&quot;biangua&quot;: { //【变卦】信息-不一定会有值
&quot;gua_mark&quot;: &quot;&quot;, //如果 has_biangua 为0，则此处的值为空。
&quot;gua_name&quot;: &quot;无变卦&quot;,
&quot;gua_qian&quot;: &quot;无卦签&quot;,
&quot;gua_qian_desc&quot;: &quot;无象曰&quot;,
&quot;gua_yaoci&quot;: &quot;无爻辞&quot;,
&quot;gua_description&quot;: {
&quot;gua_shiye&quot;: &quot;无解析&quot;,
&quot;gua_jingshang&quot;: &quot;无解析&quot;,
&quot;gua_qiuming&quot;: &quot;无解析&quot;,
&quot;gua_waichu&quot;: &quot;无解析&quot;,
&quot;gua_hunlian&quot;: &quot;无解析&quot;,
&quot;gua_juece&quot;: &quot;无解析&quot;
},
&quot;gua_xiongji&quot;: &quot;无吉凶&quot;
},
&quot;cuogua&quot;: { //【错卦】信息-永远会有值
&quot;gua_mark&quot;: &quot;101110&quot;,
&quot;gua_name&quot;: &quot;泽火革&quot;,
&quot;gua_qian&quot;: &quot;苗逢旱天渐渐衰，幸得天恩降雨来，忧去喜来能变化，求谋干事遂心怀。&quot;,
&quot;gua_qian_desc&quot;: &quot;异卦(下离上兑)相叠。离为火、兑为泽，泽内有水。水在上而下浇，火在下而上升。火旺水干；水大火熄。二者相生亦相克，必然出现变革。变革是宇宙的基本规律。&quot;,
&quot;gua_yaoci&quot;: &quot;革：己日乃孚，元亨利贞，悔亡。彖曰：革，水火相息，二女同居，其志不相得，曰革。己日乃孚；革而信也。文明以说，大亨以正，革而当，其悔乃亡。天地革而四时成，汤武革命，顺乎天而应乎人，革之时义大矣哉！象曰：泽中有火，革；君子以治历明时。初九：巩用黄牛之革。象曰：巩用黄牛，不可以有为也。六二：己日乃革之，征吉，无咎。象曰：己日革之，行有嘉也。九三：征凶，贞厉，革言三就，有孚。象曰：革言三就，又何之矣。九四：悔亡，有孚改命，吉。象曰：改命之吉，信志也。九五：大人虎变，未占有孚。象曰：大人虎变，其文炳也。上六：君子豹变，小人革面，征凶，居贞吉。象曰：君子豹变，其文蔚也。小人革面，顺以从君也。&quot;,
&quot;gua_description&quot;: {
&quot;gua_shiye&quot;: &quot;正处在转折的关键时刻，必须密切注意各种信息，认真思考。首先巩固自己的地位，完善个人的行为。时机成熟后，立即行动，积极进行变革。但应注意动机纯正，手段正当，不保守也不妄进，事业必定发达。&quot;,
&quot;gua_jingshang&quot;: &quot;市场竞争十分激烈。为了立于不败之地，一定要敢于大胆求新，适时改变自己的经营方向，受到挫败，马上总结经验，重新奋起，拓展商业活动。注意竞争方式。&quot;,
&quot;gua_qiuming&quot;: &quot;首先要努力提高自己，完善个人的学识和品德。同时，服从上级指挥搞好工作。二者的关系一定要得到妥善处理。&quot;,
&quot;gua_waichu&quot;: &quot;十分顺利，积极活动，扩大人际关系。&quot;,
&quot;gua_hunlian&quot;: &quot;可能会出现一些节外生枝的麻烦事，应冷静处理，感情专注。&quot;,
&quot;gua_juece&quot;: &quot;十分吉利、顺利。以自己的聪明才智，顺应形势，根据时代特点，依理而动，变革渐合时宜的事物，壮大自己的事业。但应谨慎，时机不成熟不可妄动，尤忌急功近利。行动之前应三思而行。&quot;
},
&quot;gua_xiongji&quot;: &quot;上上卦&quot;
},
&quot;zonggua&quot;: { //【综卦】信息-永远会有值
&quot;gua_mark&quot;: &quot;100010&quot;,
&quot;gua_name&quot;: &quot;水雷屯&quot;,
&quot;gua_qian&quot;: &quot;风刮乱丝不见头，颠三倒四犯忧愁，慢从款来左顺遂，急促反惹不自由。&quot;,
&quot;gua_qian_desc&quot;: &quot;异卦(下震上坎)相叠，震为雷，喻动；坎为雨，喻险。雷雨交加，险象丛生，环境恶劣。“屯”原指植物萌生大地。万物始生，充满艰难险阻，然而顺时应运，必欣欣向荣。&quot;,
&quot;gua_yaoci&quot;: &quot;屯：元，亨，利，贞，勿用，有攸往，利建侯。彖曰：屯，刚柔始交而难生，动乎险中，大亨贞。雷雨之动满盈，天造草昧，宜建侯而不宁。象曰：云，雷，屯；君子以经纶。初九：磐桓；利居贞，利建侯。象曰：虽磐桓，志行正也。以贵下贱，大得民也。六二：屯如邅如，乘马班如。匪寇婚媾，女子贞不字，十年乃字。象曰：六二之难，乘刚也。十年乃字，反常也。六三：既鹿无虞，惟入于林中，君子几不如舍，往吝。象曰：既鹿无虞，以纵禽也。君子舍之，往吝穷也。六四：乘马班如，求婚媾，无不利。象曰：求而往，明也。九五：屯其膏，小贞吉，大贞凶。象曰：屯其膏，施未光也。上六：乘马班如，泣血涟如。象曰：泣血涟如，何可长也。&quot;,
&quot;gua_description&quot;: {
&quot;gua_shiye&quot;: &quot;起初多不利，必知难而进，小心翼翼，勇往直前，灵活机动，可望获得大的成功，时机到来时一定要抓住，却也不得操之太急，且仍有困难，务必有他人相助，故平时应多施恩惠。&quot;,
&quot;gua_jingshang&quot;: &quot;创业初期步履艰难，多有挫折。坚定信念最重要，不要为表面现象所迷惑，应积极进取，行动果断，打开出路。若仍无法摆脱困境，则应退守保全，等待机会，再展宏图。&quot;,
&quot;gua_qiuming&quot;: &quot;积极争取，主动追求，可以成功。&quot;,
&quot;gua_waichu&quot;: &quot;慎重为好，有危险，宜改日动身。&quot;,
&quot;gua_hunlian&quot;: &quot;好事多磨，忠贞纯洁，大胆追求，能够成功，婚姻美满。&quot;,
&quot;gua_juece&quot;: &quot;初始困难，但若具有坚忍不拔的毅力和锲而不舍的奋斗精神，前途不可估量，但往往不为他人理解而陷于孤独苦闷，事业会因此处于困难状态，需要得到贤德之人的帮助才能摆脱。如能以乐观主义精神处世，能取得成就。&quot;
},
&quot;gua_xiongji&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>