星座星盘
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li>星座星盘是一种根据出生日期、时间和地点等信息，通过占星学原理进行星象排布和解读的方法。它通过对天体运行规律、星体属性和宫位的分析，来预测个人的性格特点、运势走向以及与他人的关系等方面。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/fortune/constellation</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>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>geolimits</td>
<td>Integer</td>
<td>否</td>
<td>地理范围 1：中国(需强制传递省和市) 2：世界(需强制传递经纬度) 默认：1 </td>
</tr>
<tr>
<td>province</td>
<td>String</td>
<td>是</td>
<td>省 例：北京市 geolimits为1，省和市都必传 详见<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>市 例：北京 geolimits为1，省和市都必传 详见<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>longitudeDegree</td>
<td>Integer</td>
<td>否</td>
<td>经度-度数 例：20 如果geolimits为2 时则必传，度数范围只能是在0～180之间的整数数字 </td>
</tr>
<tr>
<td>longitudeMinutes</td>
<td>Integer</td>
<td>否</td>
<td>经度-分数 例：20 如果geolimits为2 时则必传，分数范围只能是在0～59之间的整数数字 </td>
</tr>
<tr>
<td>longitudeType</td>
<td>String</td>
<td>否</td>
<td>经度-类型 例：E 例：20 如果geolimits为2 时则必传，范围 "E"，"W" 二选一</td>
</tr>
<tr>
<td>latitudeDegree</td>
<td>Integer</td>
<td>否</td>
<td>纬度-度数 例：20 如果geolimits为2 时则必传，度数范围只能是在0～90之间的整数数字 </td>
</tr>
<tr>
<td>latitudeMinutes</td>
<td>Integer</td>
<td>否</td>
<td>纬度-分数 例：20 如果geolimits为2 时则必传，分数范围只能是在0～59之间的整数数字 </td>
</tr>
<tr>
<td>latitudeType</td>
<td>String</td>
<td>否</td>
<td>纬度-类型 例：E 例：20 如果geolimits为2 时则必传，范围 "S"，"N" 二选一</td>
</tr>
<tr>
<td>timezone</td>
<td>Integer</td>
<td>否</td>
<td>时区 例：8 非必传，范围 -12～14 之间，如果不传递这个参数，默认：8 </td>
</tr>
<tr>
<td>isdst</td>
<td>Integer</td>
<td>否</td>
<td>是否夏令时 例：0：否 1：是 非必传，如果不传递这个参数，默认：0 </td>
</tr>
<tr>
<td>imageType</td>
<td>Integer</td>
<td>否</td>
<td>返回星盘图片的样式类型 例：1：第1种样式 2：第2种样式 非必传，如果不传递这个参数，默认：2 </td>
</tr>
<tr>
<td>imageTypeBackgroundR</td>
<td>Integer</td>
<td>否</td>
<td>星盘背景颜色代码R 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：255 </td>
</tr>
<tr>
<td>imageTypeBackgroundG</td>
<td>Integer</td>
<td>否</td>
<td>星盘背景颜色代码G 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：255 </td>
</tr>
<tr>
<td>imageTypeBackgroundB</td>
<td>Integer</td>
<td>否</td>
<td>星盘背景颜色代码B 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：255 </td>
</tr>
<tr>
<td>imageTypeCircleRectangle</td>
<td>Integer</td>
<td>否</td>
<td>星盘是否保留矩形背景(仅适用于image_type=2的情况) 例：1：不保留 2：保留 非必传，范围 1～2 之间，如果不传递这个参数，默认：2</td>
</tr>
<tr>
<td>imageTypeLineR</td>
<td>Integer</td>
<td>否</td>
<td>星盘线条颜色代码R(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：0</td>
</tr>
<tr>
<td>imageTypeLineG</td>
<td>Integer</td>
<td>否</td>
<td>星盘线条颜色代码G(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：0</td>
</tr>
<tr>
<td>imageTypeLineB</td>
<td>Integer</td>
<td>否</td>
<td>星盘线条颜色代码B(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：0</td>
</tr>
<tr>
<td>imageTypeOutercircleR</td>
<td>Integer</td>
<td>否</td>
<td>星盘外圈颜色代码R(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：255 </td>
</tr>
<tr>
<td>imageTypeOutercircleG</td>
<td>Integer</td>
<td>否</td>
<td>星盘外圈颜色代码G(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：255 </td>
</tr>
<tr>
<td>imageTypeOutercircleB</td>
<td>Integer</td>
<td>否</td>
<td>星盘外圈颜色代码B(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：204 </td>
</tr>
<tr>
<td>imageTypeInnercircleR</td>
<td>Integer</td>
<td>否</td>
<td>星盘内圈颜色代码R(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：153 </td>
</tr>
<tr>
<td>imageTypeInnercircleG</td>
<td>Integer</td>
<td>否</td>
<td>星盘内圈颜色代码G(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：255 </td>
</tr>
<tr>
<td>imageTypeInnercircleB</td>
<td>Integer</td>
<td>否</td>
<td>星盘内圈颜色代码B(仅适用于image_type=2的情况) 例：255 非必传，范围 0～255 之间，如果不传递这个参数，默认：153 </td>
</tr>
<tr>
<td>width</td>
<td>Integer</td>
<td>否</td>
<td>返回星盘图片的宽度 例：480 非必传，范围 480, 640, 720, 800 四选一，如果不传递这个参数，默认：640 </td>
</tr>
<tr>
<td>height</td>
<td>Integer</td>
<td>否</td>
<td>返回星盘图片的高度 例：480 非必传，范围 480, 640, 720, 800 四选一，如果不传递这个参数，默认：640 </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;xing_info&quot;: [ //第1个星体落入星座信息(总计10个星体数组)
{
&quot;xingti&quot;: &quot;太阳&quot;, //星体名
&quot;fall_xingzuo&quot;: { //落入星座
&quot;name&quot;: &quot;射手座&quot;, //太阳落入射手座
&quot;angle&quot;: {
&quot;deg&quot;: &quot;11&quot;, //太阳落入射手座度数的度信息
&quot;min&quot;: &quot;09&quot;, //太阳落入射手座度数的分信息
&quot;sec&quot;: &quot;11&quot; //太阳落入射手座度数的秒信息
},
//太阳落入射手座解析
&quot;description&quot;: &quot;太阳在射手座的人以冒险精神和自由渴望而著称。他们充满活力，乐观开朗，对生活抱有积极的态度。太阳射手喜欢探索新领域，追求知识和真理，对世界有极大的好奇心。这种渴望扩展边界的性格使他们在旅行、哲学和教育方面表现出色。然而，他们可能因为过于乐观或急于追求新事物而忽视现实和责任。在成长过程中，学习保持梦想与实践之间的平衡，有助于他们在追求个人自由的同时，实现更为长远的目标。通过倾听他人的意见和增强细致思维，他们能在冒险中获得更多有意义的经验。当他们在生活中找到归属感和稳定性时，太阳射手能够更有效地利用其热情和洞察力，产生积极的影响。&quot;
},
&quot;fall_gong&quot;: { //落入宫位
&quot;name&quot;: &quot;1宫&quot;, //太阳落入第一宫
&quot;angle&quot;: {
&quot;deg&quot;: &quot;05&quot;, //太阳落入第一宫度信息
&quot;min&quot;: &quot;45&quot;, //太阳落入第一宫分信息
&quot;sec&quot;: &quot;25&quot; //太阳落入第一宫秒信息
},
//太阳落入第一宫解析
&quot;description&quot;: &quot;太阳落在第一宫的人通常会自信满满，并且很注意自己在他人眼中的形象。你常常拥有强烈的个性，倾向于成为领导者或在群体中扮演重要角色。这种配置的人渴望得到别人的认可和尊重，因此你会努力地展现自己的优势和独特之处。太阳在此宫位的人极具表现力，通常会在人群中脱颖而出，并在各种社交场合中显得如鱼得水。然而，你也可能因为过于关注自我形象而忽视他人的感受，需要注意平衡自己的自信和顾忌他人意见的关系。&quot;
},
//是否逆行 N否 Y是
&quot;is_ret&quot;: &quot;N&quot;
},
{......}, //第2个星体落入星座信息
{......}, //第3个星体落入星座信息
{......},
......
{......},//第10个星体落入星座信息
],
&quot;gong_info&quot;: [ //各宫位置信息(总计12个宫位数组)
{
&quot;gongwei&quot;: &quot;1宫&quot;, //第1宫信息
&quot;fall_xingzuo&quot;: {
&quot;name&quot;: &quot;射手座&quot;, //第1宫落在射手座
&quot;angle&quot;: {
&quot;deg&quot;: &quot;05&quot;, //第1宫落在射手座的度信息
&quot;min&quot;: &quot;23&quot;, //第1宫落在射手座的分信息
&quot;sec&quot;: &quot;46&quot; //第1宫落在射手座的秒信息
},
////第1宫落在射手座的解析
&quot;description&quot;: &quot;命宫在射手座，体现了你天生热情、乐观和自由奔放的个性。你追求广阔的视野和精神的成长，总是渴望探索未知的领域。射手座赋予了你强烈的冒险精神，让你对生活充满好奇心与期待。你喜欢无拘无束的生活方式，在旅途中寻找到内心的平衡。对于目标的追求，你不轻易妥协，敢于突破边界，实现理想。然而，有时你的过度乐观可能让你忽略现实中的细节。建议你学会在激情与务实之间找到平衡，这样你的行动将更加高效。适合的职业包括教育、旅游、国际贸易以及哲学相关的领域。&quot;
}
},
{......}, //第2宫信息
{......}, //第3宫信息
{......}, //第4宫信息
......
{......}, //第12宫信息
],
&quot;xiang_info&quot;: [ //第1个相位信息(相位数组不固定)
{
&quot;xingti1&quot;: &quot;太阳&quot;, //星体1
&quot;xingti2&quot;: &quot;木星&quot;, //星体2
&quot;xiangwei&quot;: &quot;六合&quot;, //星体1和星体2的相位
&quot;fangxiang&quot;: &quot;出相&quot;, //方向
&quot;orb&quot;: { //容许度信息
&quot;deg&quot;: &quot;04&quot;, //容许度
&quot;min&quot;: &quot;48&quot;, //容许分
&quot;sec&quot;: &quot;30&quot; //容许秒
},
//相位信息的解析
&quot;description&quot;: &quot;当太阳与木星形成六合相位时，个人的信心和成长机会之间的状态变得尤为积极。太阳代表着自我表现与生命力，木星则象征着扩展、好运和哲学信仰。这个相位带来个人对未来的乐观态度和对多样知识的渴求，使得个体在个人发展和事业拓展中具备天然的吸引力与领导气质。它往往为人开启更多开拓视野、增长学识与获取成功的良机。如若善加利用，这一相位助力个体在追求高远目标时更具信念，时时吸取和融合新的思想，使生活和事业的每一步都朝向更大的成功迈进。与此同时，这种相位结构有利于培养慈善与仁爱的精神，使个人的生活更加丰富多样，充满正能量。&quot;
},
{......}, //第2个相位信息
{......}, //第3个相位信息
{......},
{......},
......
{......}, //第N个相位信息，N为多少不固定。
],
&quot;four_axis_info&quot;: { //四轴信息
&quot;asc&quot;: { //上升信息
&quot;fall_xingzuo&quot;: {
&quot;name&quot;: &quot;射手座&quot;, //上升射手座
&quot;angle&quot;: {
&quot;deg&quot;: &quot;05&quot;,
&quot;min&quot;: &quot;23&quot;,
&quot;sec&quot;: &quot;46&quot;
},
&quot;description&quot;: &quot;上升在射手座的人通常以乐观、热情和冒险精神著称，他们富有哲学性，喜欢追求新知和自由。射手上升表明个体具备开放的心态，对文化和思想的交流满怀兴趣。他们以积极乐观的态度面对生活，崇尚自由和广阔的空间，喜欢并善于旅行和探索。然而，容易被过度的野心和自由冲动所支配，使得他们有时显得缺乏耐力或对责任的忽视。在成长过程中，上升射手需平衡追求梦想与稳固生活基础。通过结合冒险精神与实际努力，他们能够在理解地球界限的同时壮大个人见识。在面对长远目标时，融入更加细致的规划和持久努力，将帮助他们在自由和值得仰望的成就中获取丰富经验。&quot;
}
},
&quot;mc&quot;: { //天顶信息
&quot;fall_xingzuo&quot;: {
&quot;name&quot;: &quot;处女座&quot;, //天顶处女座
&quot;angle&quot;: {
&quot;deg&quot;: &quot;22&quot;,
&quot;min&quot;: &quot;26&quot;,
&quot;sec&quot;: &quot;39&quot;
},
&quot;description&quot;: &quot;天顶处女座的人通常在职业事业中展现出对细节的关注和对工作的责任心。他们倾向于追求高标准和卓越的成就，能在细心和有条理的基础上打下稳固的职业根基。在领域和团队中，他们扮演完善和提高整体效率的角色。然而，过度追求完美和对自己或他人严苛的标准，可能导致他们疲惫不堪。学习在卓越追求和实际条件中取得平衡至关重要。他们的职业成功常缘于通过适应与改良入手提供实际价值。通过开放心态和团队协作，他们能够优化和创新工作流程。公众通常视天顶处女座的人为勤勉的榜样，并信任他们会一如既往承担起所承诺的重义务。&quot;
}
},
&quot;dsc&quot;: { //下降信息
&quot;fall_xingzuo&quot;: {
&quot;name&quot;: &quot;双子座&quot;, //下降双子座
&quot;angle&quot;: {
&quot;deg&quot;: &quot;05&quot;,
&quot;min&quot;: &quot;23&quot;,
&quot;sec&quot;: &quot;46&quot;
},
&quot;description&quot;: &quot;下降在双子座的人吸引的是聪慧、多变和健谈的伴侣。这样的人能提供多样的观点和灵活的互动方式，让生活充满活力。尽管他们自己可能更倾向于深度或专注，但由于寻找的是知识渴求和沟通能力强的人，这为关系带来了一种思想多元化的活力。在此组合中，交流是关键元素，伙伴之间的良好互动和信息交流有助于构建稳固的关系。需要警惕的是关系中可能出现的表面化或不稳定的问题。通过发展耐心和深入理解，他们能够在持续的沟通中达到关心和亲密。建设健康关系，两人需相互给予空间并尊重彼此的求知欲，在对话中形成稳定关系的基石。&quot;
}
},
&quot;ic&quot;: { //天底信息
&quot;fall_xingzuo&quot;: {
&quot;name&quot;: &quot;双鱼座&quot;, //天底双鱼座
&quot;angle&quot;: {
&quot;deg&quot;: &quot;22&quot;,
&quot;min&quot;: &quot;26&quot;,
&quot;sec&quot;: &quot;39&quot;
},
&quot;description&quot;: &quot;天底在双鱼座的人渴望一个充满梦幻、灵性和无条件爱的家庭环境，在那里可以展现最真实的自我。成长可能伴随着敏感的情感氛围，使得他们渴望在家中营造如梦似幻、富有创造力和情感支持的生活。然而，受情感驱动的生活可能导致实质安全感的缺乏。面临个人发展和家庭责任的挑战时，他们需要在灵感和实际生活选项之间做出调整。通过在价值观上体验现实与精神的结合，他们能在家庭构建中保持真实，并提供灵活包容的家园空间，赋予每一段家庭关系内心平衡与成长机会。&quot;
}
}
},
&quot;base_info&quot;: { //基本信息
&quot;sex&quot;: &quot;男&quot;, //性别
&quot;name&quot;: &quot;张三&quot;, //姓名
&quot;gongli&quot;: &quot;1980-12-03 12:05:00&quot;, //公历出生时间
&quot;nongli&quot;: &quot;一九八〇年十月廿六日 午时&quot;,//农历出生时间
&quot;shengxiao&quot;: &quot;猴&quot;, //生肖
&quot;xingzuo&quot;: &quot;射手&quot;, //星座
&quot;jingdu&quot;: &quot;39.67&quot;, //出生经度
&quot;weidu&quot;: &quot;40.83&quot;, //出生纬度
&quot;shicha&quot;: &quot;8&quot;, //时区
&quot;lingshu&quot;: &quot;6&quot; //生命灵数
},
//星盘排盘访问URL地址
&quot;image_url&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>