八字合盘
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li>八字合盘可以双方的生辰八字来以本命卦，年支同气，月令合，日干合，天干五合，合盘论吉凶，并给出相应分数，测算结果仅供参考。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/horoscope/match</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>maleName</td>
<td>String</td>
<td>是</td>
<td>甲方姓名</td>
</tr>
<tr>
<td>maleType</td>
<td>String</td>
<td>是</td>
<td>甲方历类型 0：农历 1：公历</td>
</tr>
<tr>
<td>maleBornDateTime</td>
<td>String</td>
<td>是</td>
<td>甲方出生年月日时分 格式yyyyMMddHHmm 譬如202509132155 </td>
</tr>
<tr>
<td>femaleName</td>
<td>String</td>
<td>是</td>
<td>乙方姓名</td>
</tr>
<tr>
<td>femaleType</td>
<td>String</td>
<td>是</td>
<td>乙方历类型 0：农历 1：公历</td>
</tr>
<tr>
<td>femaleBornDateTime</td>
<td>String</td>
<td>是</td>
<td>乙方出生年月日时分 格式yyyyMMddHHmm 譬如202509132155</td>
</tr>
<tr>
<td>lang</td>
<td>String</td>
<td>否</td>
<td>语言：zh-cn 、en-us 默认：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;140219966236891226178211&quot;,//本次请求号
&quot;charge&quot;: true,//计费标志
&quot;data&quot;: {
&quot;yueling&quot;: { //财运合盘
&quot;score&quot;: &quot;15&quot;, //财运合盘打分
&quot;detail_description&quot;: &quot;甲方月支为丑，乙方月支为寅。此局为寅丑暗合。月支代表财帛宫，此局暗合，预示着合作伙伴之间的默契和协作能力将会促进财务状况的良好发展。这种暗合的运势暗示着合作伙伴之间有着良好的理解和配合，彼此之间的合作关系十分默契。可能会出现合作伙伴间的资源共享、信息共享，以及相互支持的情况。关键在于合作伙伴要保持沟通畅通，密切合作，共同克服困难，不断创新，进一步巩固合作关系，共同实现财富的增长和成功。&quot;,//财运合盘详批
&quot;male_yue_zhi&quot;: &quot;丑&quot;,
&quot;female_yue_zhi&quot;: &quot;寅&quot;,
&quot;description&quot;: &quot;此项满分为20分，如果此项分数越高，说明双方合作的财运运势越好。&quot;//财运合盘简批
},
&quot;minggong&quot;: { //合作合盘
&quot;female_fengshui&quot;: &quot;西四命&quot;,
&quot;score&quot;: &quot;0&quot;, //合作合盘打分
&quot;detail_description&quot;: &quot;甲方命卦为坎，适宜合作场地方位为北方。而乙方命卦为兑，适宜合作场地方位为西方。甲方命卦方位均属于东四命，而乙方命卦方位均属于西四命。说明两人，命宫不相合，当两位合作伙伴在工作中携手合作时，有时他们的专业背景和工作方式可能并不完全契合，然而，命宫虽不同，但如果两人的性格能够互补，相互理解、支持、包容，那么他们的合作关系就会更加牢固、高效、美满。合作伙伴之间也需要彼此的包容和理解。如果两人的性格有所不同，但能够互相包容，那么他们将会在工作中相互补充，共同实现更大的成就。然而，如果两个人的性格互相排斥，彼此不愿意理解对方，就需要注意化解性格矛盾的方法。通过沟通、妥协和共同努力，他们可以找到共同点，化解分歧，从而使合作关系更加融洽，工作更加顺利。&quot;,//合作合盘详批
&quot;male_fengshui&quot;: &quot;东四命&quot;,
&quot;female_minggong&quot;: &quot;兑&quot;,
&quot;description&quot;: &quot;此项满分为10分。以东四命与西四命之说来合，如果相合，那么在选择合作场地时，应选与自己命宫相合的方位。&quot;,//合作合盘简批
&quot;male_minggong&quot;: &quot;坎&quot;
},
&quot;rigan&quot;: { //恋爱合盘
&quot;score&quot;: &quot;10&quot;, //恋爱合盘打分
&quot;detail_description&quot;: &quot;甲方日干为壬。五行信息：五行属水，谓之纯阳之水；乙方日干为庚。五行信息：五行属金，谓之纯阳之金。双方日干五行阴阳不和，暗示着恋人之间的机缘相对较小。他们可能会面对一些挑战，但也正因为这些困难，他们会更加珍惜彼此的相遇。尽管初时的机缘不济，但凭借坚持和努力，他们或许会创造出一段克服困难的美丽爱情。&quot;,//恋爱合盘详批
&quot;male_yue_zhi&quot;: &quot;壬&quot;,
&quot;female_yue_zhi&quot;: &quot;庚&quot;,
&quot;description&quot;: &quot;此项满分为20分。如果日干五行相同，一阴一阳的组合的双方恋爱的机缘最大，如甲日干逢乙日干，庚日干逢辛日干之类。&quot;//恋爱合盘简批
},
&quot;jiankang&quot;: { //健康合盘
&quot;score&quot;: &quot;10&quot;, //健康合盘打分
&quot;detail_description&quot;: &quot;甲方与乙方都注重身体健康，他们相互支持，共同促进彼此的健康与幸福。甲方与乙方互相关心，共同营造一个健康的工作环境，努力维持身体健康的同时，也鼓励对方保持良好的生活习惯。他们共同制定健康计划，定期锻炼，注重饮食营养，保持充足的睡眠，共同追求身心健康的完美平衡。在双方相互鼓励的支持下，他们的身体健康得到了保障，为合作关系的稳固发展提供了坚实的基础。&quot;,//健康合盘详批
&quot;description&quot;: &quot;此项满分为10分，如果此项分数越高，说明双方的健康运势越好。&quot; //健康合盘简批
},
&quot;nianqitongzhi&quot;: { //生意合盘
&quot;female_nian_zhi_desc&quot;: &quot;金&quot;,
&quot;score&quot;: &quot;20&quot;, //生意合盘打分
&quot;male_nian_zhi&quot;: &quot;巳&quot;,
&quot;detail_description&quot;: &quot;甲方年支为巳，乙方年支为申。此局为巳申合化水。年支代表生意宫，此局全六合，意味着双方的团队都会全力支持这次合作，而这份生意合作关系被视为上吉之兆。无论双方的商业背景如何，彼此都是贵人，拥有良好的互动和互助关系。双方的团队也会在财力和人力上给予大力支持。象征着长久的合作关系和美好的未来，双方将共同创造出更多的合作成果。&quot;,//生意合盘详批
&quot;female_nian_zhi&quot;: &quot;申&quot;,
&quot;description&quot;: &quot;此项满分为20分。如寅卯辰会东方木气，虎兔龙合作生意成功的机缘就大于其它属相；巳午未会南方火气，蛇马羊合作生意成功的机缘就大于其它属相；申酉戌会西方金气，猴鸡狗合作生意成功的机缘就大于其它属相；亥子丑会北方水气，猪鼠牛合作生意成功机缘就大于其它属相。&quot;,//生意合盘简批
&quot;male_nian_zhi_desc&quot;: &quot;火&quot;
},
&quot;female_sx&quot;: &quot;猴&quot;, //乙方生肖
&quot;tiangan&quot;: { //运势合盘
&quot;score&quot;: &quot;10&quot;, //运势合盘打分
&quot;detail_description&quot;: &quot;甲方日天干为壬，乙方日天干为庚。此局为平。日干代表命宫，主运势，此局平，甲方与乙方的运势呈现出安稳与和谐的状态。他们之间的运势关系如同平静的湖面，没有波澜，一切都在和谐相处之中。甲方与乙方或许因为相互理解和信任，能够在相处中保持平稳的节奏，共同朝着共同的目标前进。在这样的局势下，他们将能够以平和的心态处理各种事务，共同推动项目的进展。&quot;, //运势合盘详批
&quot;male_yue_zhi&quot;: &quot;壬&quot;,
&quot;female_yue_zhi&quot;: &quot;庚&quot;,
&quot;description&quot;: &quot;此项满分为20分，如果此项分数越高，说明双方的总体运势越好。&quot; //运势合盘简批
},
&quot;all_score&quot;: 65, //合盘总分
&quot;male_sx&quot;: &quot;蛇&quot;, //甲方生肖
&quot;male_xz&quot;: &quot;水瓶座&quot;, //乙方生肖
&quot;female&quot;: {
&quot;bazi&quot;: [ //乙方八字
&quot;壬申&quot;, //乙方八字【年】
&quot;壬寅&quot;, //乙方八字【月】
&quot;庚辰&quot;, //乙方八字【日】
&quot;癸未&quot; //乙方八字【时】
],
&quot;day_cs&quot;: [ //乙方八字长生衰旺
&quot;临官&quot;, //乙方八字长生衰旺【年】
&quot;绝&quot;, //乙方八字长生衰旺【月】
&quot;养&quot;, //乙方八字长生衰旺【日】
&quot;冠带&quot; //乙方八字长生衰旺【时】
],
&quot;gl_day&quot;: &quot;5&quot;, //乙方公历日
&quot;sex&quot;: &quot;坤造&quot;, //性别
&quot;dz_cg_god&quot;: [ //乙方地支藏干十神
&quot;比肩|食神|偏印&quot;, //乙方地支藏干十神【年】
&quot;偏财|七杀|偏印&quot;, //乙方地支藏干十神【月】
&quot;偏印|正财|伤官&quot;, //乙方地支藏干十神【日】
&quot;正印|正官|正财&quot; //乙方地支藏干十神【时】
],
&quot;na_yin&quot;: [ //乙方八字纳音
&quot;剑锋金&quot;, //乙方八字纳音【年】
&quot;金箔金&quot;, //乙方八字纳音【月】
&quot;白蜡金&quot;, //乙方八字纳音【日】
&quot;杨柳木&quot; //乙方八字纳音【时】
],
&quot;gl_month&quot;: &quot;3&quot;, //乙方公历月
&quot;gongli&quot;: &quot;1992年3月5日13时29分&quot;,//乙方公历年月日时分
&quot;kw&quot;: &quot;申酉&quot;,//乙方空亡
&quot;gl_hours&quot;: &quot;13&quot;, //乙方公历时
&quot;gl_year&quot;: &quot;1992&quot;, //乙方公历年
&quot;dz_cg&quot;: [ //乙方地支藏干
&quot;庚|壬|戊&quot;, //乙方地支藏干【年】
&quot;甲|丙|戊&quot;, //乙方地支藏干【月】
&quot;戊|乙|癸&quot;, //乙方地支藏干【日】
&quot;己|丁|乙&quot; //乙方地支藏干【时】
],
&quot;name&quot;: &quot;xxx&quot;, //乙方姓名
&quot;tg_cg_god&quot;: [ //乙方天干十神
&quot;食神&quot;, //乙方天干十神【年】
&quot;食神&quot;, //乙方天干十神【月】
&quot;日元&quot;, //乙方天干十神【日】
&quot;伤官&quot; //乙方天干十神【时】
]
},
&quot;female_xz&quot;: &quot;双鱼座&quot;, //乙方星座
&quot;male&quot;: {
&quot;bazi&quot;: [ //甲方八字
&quot;己巳&quot;, //甲方八字【年】
&quot;丁丑&quot;, //甲方八字【月】
&quot;壬辰&quot;, //甲方八字【日】
&quot;丁未&quot; //甲方八字【时】
],
&quot;day_cs&quot;: [ //甲方八字长生衰旺
&quot;绝&quot;, //甲方八字长生衰旺【年】
&quot;衰&quot;, //甲方八字长生衰旺【月】
&quot;墓&quot;, //甲方八字长生衰旺【日】
&quot;养&quot; //甲方八字长生衰旺【时】
],
&quot;gl_day&quot;: &quot;27&quot;, //甲方公历日
&quot;sex&quot;: &quot;乾造&quot;, //性别
&quot;dz_cg_god&quot;: [ //甲方地支藏干十神
&quot;偏财|偏印|七杀&quot;, //甲方地支藏干十神【年】
&quot;正官|劫财|正印&quot;, //甲方地支藏干十神【月】
&quot;七杀|伤官|劫财&quot;, //甲方地支藏干十神【日】
&quot;正官|正财|伤官&quot; //甲方地支藏干十神【时】
],
&quot;na_yin&quot;: [ //甲方八字纳音
&quot;大林木&quot;, //甲方八字纳音【年】
&quot;涧下水&quot;, //甲方八字纳音【月】
&quot;长流水&quot;, //甲方八字纳音【日】
&quot;天河水&quot; //甲方八字纳音【时】
],
&quot;gl_month&quot;: &quot;1&quot;,//甲方公历月
&quot;gongli&quot;: &quot;1990年1月27日13时29分&quot;,//甲方公历月
&quot;kw&quot;: &quot;午未&quot;,//甲方空亡
&quot;gl_hours&quot;: &quot;13&quot;,//甲方公历时
&quot;gl_year&quot;: &quot;1990&quot;,//甲方公历年
&quot;dz_cg&quot;: [ //甲方地支藏干
&quot;丙|庚|戊&quot;, //甲方地支藏干【年】
&quot;己|癸|辛&quot;, //甲方地支藏干【月】
&quot;戊|乙|癸&quot;, //甲方地支藏干【日】
&quot;己|丁|乙&quot; //甲方地支藏干【时】
],
&quot;name&quot;: &quot;xxx&quot;,//甲方姓名
&quot;tg_cg_god&quot;: [ //甲方天干十神
&quot;正官&quot;, //甲方天干十神【年】
&quot;正财&quot;, //甲方天干十神【月】
&quot;日元&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>