1912-2100年黄历(万年历)运势等信息查询。按年月日查询农历、星座、生肖、胎神、喜神、五行、冲、煞、吉日、值日天神、凶神、吉神宜趋、财神、喜神、福神、岁次、宜、忌、星期,吉时与吉神凶煞等黄历信息。
接口ID 47
请求方式 GET/POST
返回格式 JSON
HTTP/HTTPS 支持
接口价格 低至¥0.002/次
接口地址 https://yilianshuju.com/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; cost:单价;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请求记得用:urlencode
$api_url='https://yilianshuju.com/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; }
?>