概述
万年历"取指定日-12时辰详细信息"API是一个功能强大的免费接口,专门用于获取中国传统农历日历中指定日期的12个时辰详细数据。该接口提供了丰富的命理信息,包括干支、五行、纳音、十神、方位吉凶等90多项数据,是开发算命、风水、日历等应用的理想工具。
接口基本信息
请求地址
复制
https://cn.apihz.cn/api/time/getzddayhs.php
请求方式
支持POST和GET两种请求方式。
请求参数
名称 |
参数 |
必填 |
说明 |
用户ID |
id |
是 |
用户中心的数字ID |
用户KEY |
key |
是 |
用户中心通讯秘钥 |
查询方式 |
type |
否 |
0=按阳历查询,1=按阴历查询,默认0 |
指定年 |
nian |
是 |
指定要查询的年份(1800-2199年) |
指定月 |
yue |
是 |
指定要查询的月份 |
指定日 |
ri |
是 |
指定要查询的日 |
返回参数说明
接口返回包含90多项详细数据,主要分为以下几类:
- 1.基础信息:阳历/阴历年月日、时辰时间
- 2.干支信息:年月日时干支、生肖、冲煞
- 3.宜忌信息:当日宜忌事项
- 4.方位信息:财神、福神、喜神等方位
- 5.天神信息:十二天神吉凶类型
- 6.九星信息:北斗九星相关数据
- 7.五行八字:年月日时五行、纳音、十神等
- 8.其他命理:地势、旬空、胎元、命宫等
调用示例
GET请求示例
复制
https://cn.apihz.cn/api/time/getzddayhs.php?id=88888888&key=88888888&nian=2025&yue=10&ri=1&type=0
PHP调用示例
php
复制
<?php // 设置请求参数 $id = "您的用户ID"; $key = "您的用户KEY"; $nian = "2025"; $yue = "10"; $ri = "1"; $type = "0"; // 构建请求URL $url = "https://cn.apihz.cn/api/time/getzddayhs.php?" . "id=" . $id . "&key=" . $key . "&nian=" . $nian . "&yue=" . $yue . "&ri=" . $ri . "&type=" . $type; // 发送GET请求 $response = file_get_contents($url); // 解析JSON响应 $data = json_decode($response, true); // 检查请求是否成功 if ($data && isset($data[0]['code'])) { if ($data[0]['code'] == 200) { // 处理返回的数据 foreach ($data as $hour) { echo "时辰: " . $hour['SHICHENG'] . "\n"; echo "八字: " . $hour['ALLBAZI'] . "\n"; echo "宜: " . $hour['YI'] . "\n"; echo "忌: " . $hour['JI'] . "\n"; echo "-----------------------\n"; } } else { echo "错误: " . $data[0]['msg']; } } else { echo "请求失败"; } ?>
Python调用示例
python
下载
复制
运行
import requests import json # 设置请求参数 params = { 'id': '您的用户ID', 'key': '您的用户KEY', 'nian': '2025', 'yue': '10', 'ri': '1', 'type': '0' } # 发送GET请求 try: response = requests.get('https://cn.apihz.cn/api/time/getzddayhs.php', params=params) data = response.json() # 检查请求是否成功 if isinstance(data, list) and len(data) > 0: if 'code' in data[0]: if data[0]['code'] == 200: # 处理返回的数据 for hour in data: print(f"时辰: {hour['SHICHENG']}") print(f"八字: {hour['ALLBAZI']}") print(f"宜: {hour['YI']}") print(f"忌: {hour['JI']}") print("-----------------------") else: print(f"错误: {data[0]['msg']}") else: # 直接处理返回的时辰数据 for hour in data: print(f"时辰: {hour['SHICHENG']}") print(f"八字: {hour['ALLBAZI']}") print("-----------------------") else: print("返回数据格式异常") except requests.exceptions.RequestException as e: print(f"请求失败: {e}") except json.JSONDecodeError as e: print(f"JSON解析失败: {e}")
Python使用POST请求示例
python
下载
复制
运行
import requests import json # 设置请求参数 data = { 'id': '您的用户ID', 'key': '您的用户KEY', 'nian': '2025', 'yue': '10', 'ri': '1', 'type': '0' } # 发送POST请求 try: response = requests.post('https://cn.apihz.cn/api/time/getzddayhs.php', data=data) result = response.json() # 处理返回数据 if isinstance(result, list) and len(result) > 0: for hour_data in result: print(f"时辰: {hour_data.get('SHICHENG', 'N/A')}") print(f"干支: {hour_data.get('GANZHI', 'N/A')}") print(f"生肖: {hour_data.get('SHENGXIAO', 'N/A')}") print(f"宜: {hour_data.get('YI', 'N/A')}") print(f"忌: {hour_data.get('JI', 'N/A')}") print("五行信息:") print(f" 年: {hour_data.get('YEARWUXING', 'N/A')}") print(f" 月: {hour_data.get('MONTHWUXING', 'N/A')}") print(f" 日: {hour_data.get('DAYWUXING', 'N/A')}") print(f" 时: {hour_data.get('TIMEWUXING', 'N/A')}") print("="*50) except Exception as e: print(f"请求失败: {e}")
返回数据示例解析
接口成功调用后,会返回一个包含12个对象的数组,每个对象代表一个时辰的详细信息。以下是关键字段的说明:
基础信息字段
- •
YLYEAR,YLMONTH,YLDAY: 阳历年月日 - •
YIYEAR,YIMONTH,YIDAY: 阴历年月日 - •
SHICHENG: 时辰时间范围 - •
YIYYYYMMDD: 阴历年月日汉字写法
干支八字信息
- •
YIYEAR_GANZHI,YIMONTH_GANZHI,YIDAY_GANZHI,GANZHI: 年月日时干支 - •
ALLBAZI: 完整八字合写 - •
SHENGXIAO: 时辰生肖 - •
CHONG,CHONGGAN,CHONGGANTIE: 冲煞信息
宜忌与方位
- •
YI,JI: 宜忌事项 - •
POSITIONCAI,POSITIONFU,POSITIONXI: 财神、福神、喜神方位 - •
TIANSHEN,TIANSHENLUCK,TIANSHENTYPE: 十二天神信息
九星与命理
- •
NINESTAR系列字段: 北斗九星详细信息 - •
YEARWUXING等: 年月日时五行 - •
YEARNAYIN等: 纳音信息 - •
YEARSHISHENGAN等: 十神信息 - •
YEARDISHI等: 地势(长生十二神) - •
TAIYUAN,MINGGONG,SHENGONG: 胎元、命宫、身宫
使用注意事项
- 1.认证信息:示例中的ID和KEY为公共凭证,有调用频次限制,建议注册获取个人独享凭证。
- 2.年份范围:默认支持1800年至明年,如需更广范围需联系定制。
- 3.错误处理:始终检查返回的
code字段,400表示错误,200表示成功。 - 4.数据解析:返回数据为JSON格式,包含12个时辰对象,需循环处理。
- 5.调用限制:免费接口有每分钟调用频次限制,但每日无总上限。
应用场景
该API适用于多种应用开发场景:
- 1.算命应用:提供完整的八字排盘和命理分析数据
- 2.日历应用:显示每日宜忌和吉凶时辰
- 3.风水软件:提供方位吉凶和星象信息
- 4.传统文化教育:学习中国传统历法和命理知识
- 5.活动策划:选择吉日吉时举办重要活动
总结
万年历"取指定日-12时辰详细信息"API是一个功能全面、数据丰富的免费接口,为开发者提供了便捷的传统日历和命理数据获取途径。通过简单的HTTP请求即可获得专业的命理分析数据,大大降低了开发相关应用的技术门槛。无论是个人兴趣项目还是商业应用,这个API都能提供强大的数据支持。