输入任意公历日期(如2025-10-01),即可秒级获取公农历对照、节气假期、纳音五行、星宿吉凶、财神喜神方位、彭祖百忌、冲煞方位等老黄历数据,假日调休实时同步,精度覆盖1900-2100年,轻松为您的日程、择吉、命理分析提供一站式权威接口。(含有部分虚构内容,请相信科学)
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| date | datetime | 否 | 日期,Y-m-d格式,如:2025-10-01,默认当前日期 | 2025-10-01 |
[
{
"name": "date",
"type": "datetime",
"required": false,
"description": "日期,Y-m-d格式,如:2025-10-01,默认当前日期",
"example": "2025-10-01"
}
]
{"openapi":"3.1.1","info":{"title":"农历","description":"输入任意公历日期(如2025-10-01),即可秒级获取公农历对照、节气假期、纳音五行、星宿吉凶、财神喜神方位、彭祖百忌、冲煞方位等老黄历数据,假日调休实时同步,精度覆盖1900-2100年,轻松为您的日程、择吉、命理分析提供一站式权威接口。(含有部分虚构内容,请相信科学)","version":"1.0.0"},"paths":{"/v1/nongli.php":{"get":{"summary":"农历","description":"输入任意公历日期(如2025-10-01),即可秒级获取公农历对照、节气假期、纳音五行、星宿吉凶、财神喜神方位、彭祖百忌、冲煞方位等老黄历数据,假日调休实时同步,精度覆盖1900-2100年,轻松为您的日程、择吉、命理分析提供一站式权威接口。(含有部分虚构内容,请相信科学)","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string","example":"2025-10-01"},"description":"日期,Y-m-d格式,如:2025-10-01,默认当前日期"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"农历","description":"输入任意公历日期(如2025-10-01),即可秒级获取公农历对照、节气假期、纳音五行、星宿吉凶、财神喜神方位、彭祖百忌、冲煞方位等老黄历数据,假日调休实时同步,精度覆盖1900-2100年,轻松为您的日程、择吉、命理分析提供一站式权威接口。(含有部分虚构内容,请相信科学)","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string","example":"2025-10-01"},"description":"日期,Y-m-d格式,如:2025-10-01,默认当前日期"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"current_date": "2026-09-07",
"today_festivals": [
{
"name": "白露",
"description": "白露太阳黄经165°,约在9月7日,《月令》载“露凝而白”。南方收清露制白露茶,北方“十样白”炖鸡补身,农业上华南晚稻抽穗、华北玉米收获。养生防“秋燥伤肺”,食梨、芝麻,添衣防“白露身不露”,谚语“白露秋分夜,一夜凉一夜”形象描绘气温速降。",
"type": "中国传统"
},
{
"name": "国际秃鹰日",
"description": "关注食腐鸟类",
"type": "国际主题日"
}
],
"next_festival": {
"name": "国际扫盲日",
"date": "2026-09-08",
"days_away": 1,
"description": "1965年联合国教科文组织将9月8日定为“国际扫盲日”,2025年主题“转型教育·扫盲与数字技能”。各国开展成人识字班、移动阅读APP推广,发布《全球扫盲报告》,强调功能性扫盲与数字素养并重,助力边缘群体获得就业与参与现代社会的机会。",
"type": "国际主题日"
}
}
提供公历日期转农历及老黄历信息查询,输入任意公历日期可获取公农历对照、节气假期、五行星宿吉凶、财神喜神方位、彭祖百忌、冲煞方位等传统历法数据,覆盖1900-2100年,适用于日程规划、择吉选择及命理分析等场景。
/v1/nongli.php
GET、POST
无需密钥。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| date | datetime | 否 | 日期,Y-m-d 格式,如:2025-10-01,默认当前日期 |
{
"current_date": "2026-09-07",
"today_festivals": [
{
"name": "白露",
"description": "白露太阳黄经165°,约在9月7日,《月令》载"露凝而白"。南方收清露制白露茶,北方"十样白"炖鸡补身,农业上华南晚稻抽穗、华北玉米收获。养生防"秋燥伤肺",食梨、芝麻,添衣防"白露身不露",谚语"白露秋分夜,一夜凉一夜"形象描绘气温速降。",
"type": "中国传统"
},
{
"name": "国际秃鹰日",
"description": "关注食腐鸟类",
"type": "国际主题日"
}
],
"next_festival": {
"name": "国际扫盲日",
"date": "2026-09-08",
"days_away": 1,
"description": "1965年联合国教科文组织将9月8日定为"国际扫盲日",2025年主题"转型教育·扫盲与数字技能"。各国开展成人识字班、移动阅读APP推广,发布《全球扫盲报告》,强调功能性扫盲与数字素养并重,助力边缘群体获得就业与参与现代社会的机会。",
"type": "国际主题日"
}
}
| 字段名 | 类型 | 说明 |
|---|---|---|
| current_date | string | 查询的公历日期,格式为 Y-m-d |
| today_festivals | array | 当日节日列表,包含传统节日、节气及国际主题日等 |
| today_festivals[].name | string | 节日或节气名称 |
| today_festivals[].description | string | 节日详细描述与习俗说明 |
| today_festivals[].type | string | 节日类型,取值包括但不限于:中国传统、国际主题日、农历节日、二十四节气 |
| next_festival | object | 下一个即将到来的节日信息,若当日无后续节日则返回空 |
| next_festival.name | string | 下一个节日名称 |
| next_festival.date | string | 下一个节日日期,格式为 Y-m-d |
| next_festival.days_away | integer | 距离下一个节日的天数 |
| next_festival.description | string | 下一个节日详细描述 |
| next_festival.type | string | 下一个节日类型 |
{
"code": 0,
"msg": "接口维护中",
"errcode": 11006
}
| errcode | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
curl -X GET "https://api.example.com/v1/nongli.php?date=2025-10-01"
// GET 请求示例
$url = "https://api.example.com/v1/nongli.php?date=2025-10-01";
$response = file_get_contents($url);
$data = json_decode($response, true);
// POST 请求示例
$ch = curl_init("https://api.example.com/v1/nongli.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(["date" => "2025-10-01"]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
date 参数接受 Y-m-d 格式的日期字符串,如 2025-10-01;若不传该参数,默认返回当前日期对应的数据。暂无代码示例。管理员可在后台用 AI 生成或手动编写。
// 结果将在此处显示