每日运势
<p>[TOC]</p>
<h3>接口描述</h3>
<ul>
<li> 八字，即生辰八字，是一个人出生时的干支历日期。年干和年支组成年柱，月干和月支组成月柱，日干和日支组成日柱，时干和时支组成时柱，一共四柱，四个干和四个支共八个字，故又称四柱八字。是命理研究方法之中最正统的一种。并在此基础上，结合古籍测算出结合当日的干支，五行生克，获取当日运势，宜忌，吉祥方位，首饰，食物，爱情运势事业分数，用以趋吉避凶。至于返回的幸运颜色、数字，食物，首饰，宜忌具体有多少种，可以参考<a href="#数据集合说明">数据集合(八字每日运势)</a></li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/horoscope/fortune</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>String</td>
<td>是</td>
<td>性别 0：男 1：女</td>
</tr>
<tr>
<td>type</td>
<td>String</td>
<td>是</td>
<td>历类型 0：农历 1：公历</td>
</tr>
<tr>
<td>birthDay</td>
<td>String</td>
<td>是</td>
<td>出生年月日时分 格式yyyyMMddHHmm 譬如202509132155 </td>
</tr>
<tr>
<td>sect</td>
<td>String</td>
<td>否</td>
<td>流派 例：1：晚子时日柱算明天 2：晚子时日柱算当天 默认：1</td>
</tr>
<tr>
<td>zhen</td>
<td>String</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 、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;297667220221147391480569&quot;,//本次请求号
&quot;charge&quot;: true,//计费标志
&quot;data&quot;: {
&quot;base_info&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; //考虑真太阳的时差
},
&quot;sex&quot;: &quot;坤造&quot;, //性别：男为乾造，女为坤造
&quot;name&quot;: &quot;张三&quot;, //姓名
&quot;gongli&quot;: &quot;2000-11-08 12:05:00&quot;, //公历年
&quot;nongli&quot;: &quot;二〇〇〇年十月十三日 午时&quot;,//农历年
&quot;yeargz&quot;: &quot;庚辰&quot;, //八字年干支
&quot;monthgz&quot;: &quot;丁亥&quot;, //八字月干支
&quot;daygz&quot;: &quot;庚午&quot;, //八字日干支
&quot;hourgz&quot;: &quot;壬午&quot;, //八字时干支
&quot;zhengge&quot;: &quot;食神格&quot;, //八字正格
&quot;shengxiao&quot;: &quot;龙&quot;, //八字生肖
&quot;xiyongshen&quot;: { //喜用神 无敌律数八字五行量化法
&quot;qiangruo&quot;: &quot;八字偏弱&quot;, //八字强弱
&quot;xiyongshen&quot;: &quot;金，水&quot;, //以金，水为喜用神
&quot;jishen&quot;: &quot;水&quot;, //以水为忌神
&quot;xiyongshen_desc&quot;: &quot;身弱，需补助，避免克泄耗，喜用金补水，避木忌土火。&quot;, //喜用神说明
&quot;jin_number&quot;: 0, //五行统计 金有0个
&quot;mu_number&quot;: 1, //五行统计 木有1个
&quot;shui_number&quot;: 2, //五行统计 水有2个
&quot;huo_number&quot;: 3, //五行统计 火有3个
&quot;tu_number&quot;: 2, //五行统计 土有2个
&quot;tonglei&quot;: &quot;金水&quot;, //同类为金水
&quot;yilei&quot;: &quot;木火土&quot;, //异类为木火土
&quot;rizhu_tiangan&quot;: &quot;水&quot; //命主五行属水
&quot;zidang&quot;: 0, //自党分
&quot;yidang&quot;: 9, //异党分
&quot;zidang_percent&quot;: &quot;0%&quot;, //自党占百分比
&quot;yidang_percent&quot;: &quot;100%&quot;,//异党占百分比
&quot;jin_score&quot;: 75, //五行金能量分数
&quot;mu_score&quot;: 16, //五行木能量分数
&quot;shui_score&quot;: 118,//五行水能量分数
&quot;huo_score&quot;: 36,//五行火能量分数
&quot;tu_score&quot;: 139,//五行土能量分数
&quot;jin_score_percent&quot;: &quot;19.53%&quot;, //五行金能量占比
&quot;mu_score_percent&quot;: &quot;4.17%&quot;, //五行木能量占比
&quot;shui_score_percent&quot;: &quot;30.73%&quot;, //五行水能量占比
&quot;huo_score_percent&quot;: &quot;9.38%&quot;, //五行火能量占比
&quot;tu_score_percent&quot;: &quot;36.2%&quot;, //五行土能量占比
&quot;yinyang&quot;: &quot;阴阳平衡&quot; //五行阴阳参考
},
&quot;wuxing_xiji&quot;: &quot;喜金 用土 闲水 仇木 忌火&quot; //五行喜忌
},
&quot;yunshi_info&quot;: { //运势信息
&quot;lucky_number&quot;: &quot;4、9&quot;, //今日幸运数
&quot;lucky_color&quot;: &quot;白色、银色、金色&quot;,//今日幸运颜色
&quot;lucky_accessory&quot;: &quot;金项链、金手镯、钢戒指&quot;,//今日开运首饰
&quot;lucky_foods&quot;: &quot;白萝卜、银耳、百合、白果、梨&quot;,//今日开运食物
&quot;lucky_directions&quot;: &quot;西方、西北方&quot;,//今日吉位
&quot;lucky_yi&quot;: &quot;开市、纳财、立券&quot;,//今日宜做
&quot;lucky_ji&quot;: &quot;嫁娶、订婚、纳采&quot;,//今日不宜
&quot;health_score&quot;: 75, //今日健康分数
&quot;career_score&quot;: 80, //今日事业分数
&quot;love_score&quot;: 80, //今日爱情分数
&quot;wealth_score&quot;: 70, //今日财富分数
&quot;fortune_score&quot;: 76, //今日运势分数
&quot;jixiong_today&quot;: &quot;中吉&quot;, //今日总体吉凶
&quot;health_description&quot;: &quot;今日健康运势聚焦肺部健康。在空气清新处进行深呼吸练习，戒烟......&quot;, //今日健康运势说明
&quot;career_description&quot;: &quot;今日事业运势积极向好，新机会纷至沓来。公司培训活动中你积极......&quot;, //今日事业运势说明
&quot;love_description&quot;: &quot;今日爱情运势佳，单身的你宛如春日花园中散发芬芳的花朵，吸引着......&quot;, //今日爱情运势说明
&quot;wealth_description&quot;: &quot;今日的财富运势积极活跃，机遇频现。可能会在网络平台上分享......&quot;, //今日财富运势说明
&quot;fortune_description&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>
<h3>数据集合说明</h3>
<p>我们提供本接口使用的一些常用数据集合，对于一些想使用多语言的用户，可以考虑对这些集合数据进行翻译成其他语言，然后对应著一一进行替换即可。</p>
<table>
<thead>
<tr>
<th>集合类型</th>
<th>集合数据</th>
</tr>
</thead>
<tbody>
<tr>
<td>十天干集合<code>(包含地支藏干)</code></td>
<td>'甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'</td>
</tr>
<tr>
<td>十二地支集合</td>
<td>'子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'</td>
</tr>
<tr>
<td>十神集合[古代版]<code>(包含藏干十神)</code></td>
<td>'比', '劫', '食', '伤', '财', '才', '杀', '官', '枭', '印', '日元'</td>
</tr>
<tr>
<td>十神集合[现代版]<code>(包含藏干十神)</code></td>
<td>'比肩', '劫财', '食神', '伤官', '正财', '偏财', '七杀', '正官', '偏印', '正印', '日元'</td>
</tr>
<tr>
<td>十二长生集合</td>
<td>'长生', '沐浴', '冠带', '临官', '帝旺', '衰', '病', '死', '墓', '绝', '胎', '养'</td>
</tr>
<tr>
<td>五行集合</td>
<td>'金', '木', '水', '火', '土'</td>
</tr>
<tr>
<td>纳音集合</td>
<td>'海中金','大溪水','覆灯火','沙中金','泉中水','山头火', '涧下水','炉中火','沙中土','天河水','山下火','屋上土', '霹雳火','城头土','大林木','天上火','大驿土','平地木', '壁上土','松柏木','白蜡金','路旁土','石榴木','钗钏金', '桑柘木','金箔金','长流水','杨柳木','剑锋金','大海水'</td>
</tr>
<tr>
<td>八卦集合</td>
<td>'乾', '坤', '震', '艮', '离', '坎', '兑', '巽'</td>
</tr>
<tr>
<td>十二生肖集合</td>
<td>'鼠', '牛', '虎', '兔', '龙', '蛇', '马', '羊', '猴', '鸡', '狗', '猪'</td>
</tr>
<tr>
<td>十二星座集合</td>
<td>'水瓶座', '双鱼座', '白羊座', '金牛座', '双子座', '巨蟹座', '狮子座', '处女座', '天秤座', '天蝎座', '射手座', '摩羯座'</td>
</tr>
<tr>
<td>神煞集合</td>
<td>空亡, 天乙贵人, 太极贵人, 天医, 天德贵人, 月德贵人, 禄神, 羊刃, 孤鸾, 三奇贵人, 天赦, 德秀贵人, 魁罡, 金神, 天罗, 地网, 文昌贵人, 金舆, 福星贵人, 国印贵人,天厨贵人, 学堂, 红艳, 流霞, 将星, 华盖, 驿马, 劫煞, 亡神, 元辰(大耗),孤辰, 寡宿, 灾煞, 六厄, 勾煞, 绞煞, 童子, 词馆, 红鸾, 天喜, 桃花, 干禄,十灵, 十恶大败, 白虎, 天狗, 日德, 日贵, 进神, 福德, 六秀, 阴差阳错</td>
</tr>
<tr>
<td>奇门九星集合</td>
<td>'天蓬星', '天芮星', '天冲星", '天辅星', '天禽星', '天心星', '天柱星', '天任星', '天英星'</td>
</tr>
<tr>
<td>奇门八门集合</td>
<td>'休门', '死门', '伤门', '杜门', '中门', '开门', '惊门', '生门', '景门'</td>
</tr>
<tr>
<td>奇门九神集合</td>
<td>'值符', '螣蛇', '太阴', '六合', '勾陈', '太常', '朱雀', '九地', '九天', '白虎', '玄武'</td>
</tr>
<tr>
<td>每日运势颜色范围<code>(星座、生肖)</code></td>
<td>颜色范围：棕色, 黄色, 深红色, 红色, 天蓝色, 橄榄绿, 黑色, 深绿色, 粉红色, 橙色, 金色, 玫瑰红, 白色, 紫色, 灰色, 深蓝色, 绿色, 青色</td>
</tr>
<tr>
<td>每日运势宝石范围<code>(星座、生肖)</code></td>
<td>宝石范围：紫水晶, 草绿石, 红宝石, 蓝宝石, 紫罗兰,钻石, 金石, 绿松石, 黑曜石, 琥珀, 绿幽灵, 紫晶, 蛋白石, 红玛瑙, 黄玉, 珍珠, 翡翠, 碧玺, 玉髓, 蓝猫眼石</td>
</tr>
<tr>
<td>每日运势数字范围<code>(星座、生肖、八字)</code></td>
<td>数字范围：1～99</td>
</tr>
<tr>
<td>每日运势数字范围<code>(八字每日运势)</code></td>
<td>数字范围：0、1、2、3、4、5、6、7、8、9</td>
</tr>
<tr>
<td>每日运势颜色范围<code>(八字每日运势)</code></td>
<td>颜色范围：白色、银色、金色、青色、绿色、黑色、蓝色、赤色、红色、黄色、棕色</td>
</tr>
<tr>
<td>每日运势方位范围<code>(八字每日运势)</code></td>
<td>方位范围：西方、西北方、东方、东南方、北方、 南方、中央、东北方、西南</td>
</tr>
<tr>
<td>每日运势食物范围<code>(八字每日运势)</code></td>
<td>食物范围：白萝卜、银耳、百合、白果、梨、豆腐、牛奶、白芝麻、杏仁、山药、梨膏、银耳羹、白果炖鸡、白萝卜汁、豆腐脑、燕麦片、莲藕、马蹄、甘蔗、百合粥、杏仁露、 牛奶炖蛋、银耳莲子汤、白萝卜炖排骨、菠菜、芹菜、 韭菜、油麦菜、西兰花、青苹果、猕猴桃、绿豆芽、青豆、春卷、菠菜面、青豆泥、芹菜汁、猕猴桃汁、韭菜盒子、芹菜炒豆干、油麦菜沙拉、西兰花炒虾仁、菠菜蛋花汤、青苹果汁、黑豆、黑芝麻、海带、紫菜、黑木耳、黑米、乌鸡、生蚝、紫菜汤、海带炖排骨、 黑芝麻糊、桑葚酒、黑木耳炒肉、黑豆粥、生蚝煎、紫菜包饭、海带丝、黑米红枣粥、乌鸡白凤汤、紫菜蛋花汤、 海带豆腐汤、黑芝麻汤圆、红枣、枸杞、西红柿、樱桃、红豆、羊肉、红糖、桂圆、樱桃酱、红豆沙、红枣糕、枸杞茶、西红柿炒蛋、羊肉泡馍、红糖发糕、红豆薏米粥、樱桃酸奶、红酒炖牛肉、桂圆莲子羹、红枣枸杞茶、西红柿牛腩、红糖馒头、小米、南瓜、玉米、土豆、黄豆、胡萝卜、红薯、栗子、黄小米、小米粥、南瓜饼、玉米汁、土豆泥、山药糕、黄豆豆浆、胡萝卜炖牛腩、红薯粥、黄小米饭、栗子烧鸡、南瓜粥、玉米烙、土豆烧牛肉、山药排骨汤、黄豆炖猪蹄</td>
</tr>
<tr>
<td>每日运势配饰范围<code>(八字每日运势)</code></td>
<td>配饰范围：冰种玉手镯, 原木手串, 土棕色领结, 土色发夹, 土色手链, 土黄色丝巾, 土黄项链, 木制戒指, 木制眼镜, 木制胸针, 木头发夹, 木头戒指, 木手杖, 木梳, 木珠手链, 木珠链, 木耳坠, 木质手表, 木质耳环, 木质腰饰, 木质项链, 木雕戒指, 木雕挂坠, 朱砂手串, 棕玉手镯, 棕色发簪, 棕色帽子, 棕色戒指, 棕色皮饰, 棕色腰带, 植物胸针, 水晶发饰, 水晶挂饰, 水晶耳坠, 水晶项链, 水滴吊坠, 水滴形耳饰, 水纹丝巾, 水纹手表, 水色围巾, 海蓝宝戒, 深蓝领结, 火焰图案胸针, 火焰形戒指, 火焰形挂饰, 火焰形耳钉, 火焰纹袖扣, 火焰项链, 火红手链, 烈焰耳饰, 玛瑙项链, 玫瑰金耳环, 玫红包链, 珍珠耳环, 琥珀吊坠, 琥珀耳坠, 砂岩耳饰, 竹制发簪, 竹节手链, 红宝石发卡, 红宝石戒指, 红宝耳坠, 红曜石戒指, 红水晶戒指, 红玛瑙吊坠, 红珊瑚项链, 红色丝巾, 红色发带, 红色项链, 蓝宝石耳钉, 蓝宝石胸针, 蓝玉髓吊坠, 蓝色发夹, 蓝色手链, 藤编包, 贝壳项链, 金发夹, 金属吊坠, 金属帽扣, 金属扣包, 金属眼镜框, 金属纽扣, 金属表链, 金属饰边包, 金手链, 金手镯, 金色手表, 金色耳坠, 金色腰带扣, 金链坠, 金项链, 钛合金戒指, 钢戒指, 铂金戒指, 银戒, 银耳环, 银胸针, 黄土色胸针, 黄水晶戒指, 黄玉吊坠, 黄玉戒指, 黄玛瑙手串, 黄铜耳钉, 黑曜石手链, 黑水晶戒指</td>
</tr>
<tr>
<td>每日运势宜忌范围<code>(八字每日运势)</code></td>
<td>宜忌范围：开市,纳财,立券,交易,求财,挂匾,置产, 出货财,买车,赴任,见贵,求医,治病,探病,安机械, 开仓,纳畜,投资,缝补,艾灸,作染,入学,理发,会亲友, 训畜,习艺,祈福,求嗣,结网,栽种,捕捉,畋猎,牧养, 针灸,整手足甲,剃头,乘船,渡水,出行,入宅,安香, 扫舍,祭祀,求雨,酬神,普渡,斋醮,焚香,沐浴,解除, 脱毛,移徙,分居,归宁,问病情,见友人,问名,出火, 破屋,断蚁,行丧,书法,经络,嫁娶,订婚,纳采,安床, 合帐,冠笄,开光,塑绘,裁衣,作灶,修造,动土,上梁, 竖柱,盖屋,拆卸,破土,开厕,造屋,合脊,修门,安葬, 立碑,启钻,修坟,入殓,移柩,安门,补垣,坏垣,起基, 定磉,塞穴,筑堤,开池,掘井,平治道涂,修饰垣墙, 作梁,开井开池,作厕,修仓</td>
</tr>
<tr>
<td>八字正格范围</td>
<td>正印格、正财格、建禄格、劫财格、偏财格、食神格、伤官格、七杀格、 正官格、偏印格、未入格</td>
</tr>
</tbody>
</table>