1912-2100年黄历信息查询。按年月日查询农历、星座、生肖、胎神、喜神、五行、冲、煞、吉日、值日天神、凶神、吉神宜趋、财神、喜神、福神、岁次、宜、忌、星期,吉时与吉神凶煞等黄历信息。
接口ID 47
请求方式 GET/POST
返回格式 JSON
HTTP/HTTPS 支持
接口价格 低至¥0.002/次
接口地址 https://api.yuanxiapi.cn/api/
参数说明 获取秘钥
参数 | 必填 | 说明 |
---|---|---|
id | 是 | 接口ID |
key | 是 | 对接秘钥 |
year | 是 | 年 |
month | 是 | 月 |
day | 是 | 日 |
返回参数
名称 | 说明 | ||
---|---|---|---|
year | 年 | ||
month | 月 | ||
day | 日 | ||
yangli | 阳历日期 | ||
nongli | 农历日期 | ||
week | 周几 | ||
emonth | 英文月 | ||
eweek | 英文周几 | ||
star | 星座 | ||
shengxiao | 生肖 | ||
wuxing | 五行 | ||
taishen | 胎神 | ||
chong | 冲 | ||
sha | 煞 | ||
jiri | 吉日 | ||
zhiri | 值日天神 | ||
xiongshen | 凶神 | ||
jishenyiqu | 吉神宜趋 | ||
caishen | 财神 | ||
xishen | 喜神 | ||
fushen | 福神 | ||
suici | 岁次 | ||
yi | 宜 | ||
ji | 忌 | ||
jishi | 吉时数组 | ||
jishenxiongsha | 吉神凶煞数组 | ||
code | 200:成功; 计费 | ||
user_info | 用户信息; zid:用户ID; rmb:余额; login_time:最近登录; |
返回示例
{ "code": 200, "msg": "success", "data": { "year": "2025", "month": "7", "day": "4", "yangli": "公元2025年07月04日", "nongli": "农历二〇二五年六月初十", "week": "五", "emonth": "July", "eweek": "FRIDAY", "star": "巨蟹座", "shengxiao": "蛇", "wuxing": "山头火", "taishen": "门鸡栖外西南", "chong": "冲(戊辰)龙", "sha": "煞北", "jiri": null, "zhiri": "天刑(黑道日)", "xiongshen": "狱日 死气 官符 临日 天刑 五鬼", "jishenyiqu": "七圣 神在 天仓 三合 普护 时阴 不将", "caishen": "东北", "xishen": "东北", "fushen": "正北", "suici": [ "乙巳年", "壬午月", "甲戌日" ], "yi": [ "嫁娶", "纳采", "祭祀", "祈福", "出行", "立券", "移徙", "入宅", "动土", "破土", "安葬" ], "ji": [ "开光", "作灶", "造屋", "架马", "开仓" ], "jishi": { "zi": { "shizhu": "甲子", "shijian": "23:00:00-0:59:59", "shichong": "冲马", "jixiong": "天牢(凶)", "jishen": "无", "xiongshen": "天牢" }, "chou": { "shizhu": "乙丑", "shijian": "1:00:00-2:59:59", "shichong": "冲羊", "jixiong": "玄武(凶)", "jishen": "天乙贵人", "xiongshen": "玄武" }, "yin": { "shizhu": "丙寅", "shijian": "3:00:00-4:59:59", "shichong": "冲猴", "jixiong": "司命(吉)", "jishen": "司命日禄喜神福星贵人", "xiongshen": "无" }, "mao": { "shizhu": "丁卯", "shijian": "5:00:00-6:59:59", "shichong": "冲鸡", "jixiong": "勾陈(凶)", "jishen": "日合", "xiongshen": "勾陈" }, "cheng": { "shizhu": "戊辰", "shijian": "7:00:00-8:59:59", "shichong": "冲狗", "jixiong": "青龙(吉)", "jishen": "青龙", "xiongshen": "日破" }, "si": { "shizhu": "己巳", "shijian": "9:00:00-10:59:59", "shichong": "冲猪", "jixiong": "明堂(吉)", "jishen": "明堂文昌贵人", "xiongshen": "无" }, "wu": { "shizhu": "庚午", "shijian": "11:00:00-12:59:59", "shichong": "冲鼠", "jixiong": "天刑(凶)", "jishen": "无", "xiongshen": "天刑" }, "wei": { "shizhu": "辛未", "shijian": "13:00:00-14:59:59", "shichong": "冲牛", "jixiong": "朱雀(凶)", "jishen": "天乙贵人", "xiongshen": "朱雀日刑" }, "shen": { "shizhu": "壬申", "shijian": "15:00:00-16:59:59", "shichong": "冲虎", "jixiong": "金匮(吉)", "jishen": "金匮日马", "xiongshen": "无" }, "you": { "shizhu": "癸酉", "shijian": "17:00:00-18:59:59", "shichong": "冲兔", "jixiong": "天德(吉)", "jishen": "天德天官贵人", "xiongshen": "日害" }, "xu": { "shizhu": "甲戌", "shijian": "19:00:00-20:59:59", "shichong": "冲龙", "jixiong": "白虎(凶)", "jishen": "无", "xiongshen": "白虎" }, "hai": { "shizhu": "乙亥", "shijian": "21:00:00-22:59:59", "shichong": "冲蛇", "jixiong": "玉堂(吉)", "jishen": "玉堂", "xiongshen": "无" }, "ut": "2024-06-04 10:34:13", "msg": "查询成功" }, "jishenxiongsha": { "niankongwang": "寅卯", "nianqisha": "亥", "niansansha": "东 三煞寅卯辰 甲乙坐煞", "yuekongwang": "申酉", "yueqisha": "子", "yuesansha": "北 三煞亥子丑 壬癸坐煞", "rikongwang": "申酉", "riqisha": "辰", "risansha": "北 三煞亥子丑 壬癸坐煞", "xishen": "东北", "yueling": "壬午", "rilu": "寅命互禄", "fushen": "正北", "yuezhi": "午火", "niantaisui": "吴遂", "caishen": "东北", "zhongdong": "季夏", "taisuiwei": "东南", "yangguishen": "西南", "yuexiang": "宵月", "suipowei": "西北", "yinguishen": "东北", "wuhou": "半夏生", "fantaisui": "蛇、猪、虎、猴", "yjgx": "水山蹇", "tjjs": "寅,巳,亥", "jiuxing": "八白太阴土星(吉)", "esbx": "北方牛宿牛金牛(凶)", "zhiri12": "定执位 — 吉:俗称“小黄道日”。吉。依古籍观点,此日宜晏饮、协议,忌医疗、诉讼及选将出师。晏饮是为了固定某种关系和达成某种共识,协议则是对双方的约定,故“定”日宜晏饮、协议;医疗、诉讼和出师则需随机应变,墨守定规的做法是注定要以失败而告终的,故“定”日忌医疗、诉讼和出师。 诗云: 定可魁货及安床,结婚合和百代昌;安葬平基亦可用,不宜见官说短长。 修造用之相无虑,粮解逢之都不良;入宅作灶莫大意,如有紫薇亦无妨。", "zhishen12": "天刑 — 凶:俗称“大黑道日”。古籍云:天刑星,利于出师,战无不克,其它动作谋为皆不宜用,大忌词讼。", "liuyao": "佛灭 — 凶:依古籍观点,寓意万事化凶。也作弘灭,大凶之日,诸事不宜。 六曜,又称孔明六曜星、小六壬,是中国传统历法中的一种注文。后来传至日本,并于当地流行,而在中国影响日渐式微。", "ut": "2024-06-04 10:34:13", "msg": "查询成功" } }, "user_info": { "zid": "217", "rmb": "992.85342", "login_time": "2025-08-17 22:40:38" } }
服务级错误码(code)
错误码 | 说明 |
---|---|
201 | 请求参数错误 |
202 | 查询失败 |
203 | 请求错误 |
204 | 查无结果 |
系统级错误码(error_code)
错误码 | 说明 |
---|---|
101 | 错误的请求KEY |
102 | 被禁止的KEY |
103 | 被禁止的IP |
104 | 请求超过次数限制 |
105 | 此IP请求超过限制 |
106 | 未知的请求源 |
107 | 接口维护 |
108 | 余额不足 |
109 | 未完成认证 |
110 | 接口不存在 |
PHP代码示例:
<?php //GET请求记得用:urldecode $api_url='https://api.yuanxiapi.cn/api/'; $api_id='接口ID'; $key='秘钥'; $post_arr=array('id'=>$api_id,'key'=>$key,'phone'=>'参数值'); $post=http_build_query($post_arr); $data=get_curl($api_url,$post); print_r($data); function get_curl($url, $post=0, $referer=0, $cookie=0, $header=0, $ua=0, $nobaody=0, $addheader=0){ $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); $httpheader[] = "Accept: */*"; $httpheader[] = "Accept-Encoding: gzip,deflate,sdch"; $httpheader[] = "Accept-Language: zh-CN,zh;q=0.8"; $httpheader[] = "Connection: close"; if($addheader){ $httpheader = array_merge($httpheader, $addheader); } curl_setopt($ch, CURLOPT_HTTPHEADER, $httpheader); if ($post) { curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $post); } if ($header) { curl_setopt($ch, CURLOPT_HEADER, true); } if ($cookie) { curl_setopt($ch, CURLOPT_COOKIE, $cookie); } if($referer){ if($referer==1){ curl_setopt($ch, CURLOPT_REFERER, 'http://m.qzone.com/infocenter?g_f='); }else{ curl_setopt($ch, CURLOPT_REFERER, $referer); } } if ($ua) { curl_setopt($ch, CURLOPT_USERAGENT, $ua); } else { curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0 (Linux; U; Android 4.0.4; es-mx; HTC_One_X Build/IMM76D) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0"); } if ($nobaody) { curl_setopt($ch, CURLOPT_NOBODY, 1); } curl_setopt($ch, CURLOPT_ENCODING, "gzip"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $ret = curl_exec($ch); curl_close($ch); return $ret; } ?>