首页›黄历 API 文档

黄历开放 API

农历 · 干支 · 生肖 · 星座 · 宜忌 · 节日 一站式查询接口

接口地址

GET http://jieri.ronhu.com/almanac_api.php?key=你的KEY&y=2026&m=10&d=12

y / m / d 可省略,缺省为今天。返回 JSON。

参数说明

参数必填说明
key是API Key(后台生成)
y否年份,1900-2100,默认今年
m否月份,1-12,默认本月
d否日,1-31,默认今天

调用示例

curl "http://jieri.ronhu.com/almanac_api.php?key=KEY&y=2026&m=10&d=12" # Python import requests r = requests.get("http://jieri.ronhu.com/almanac_api.php", params={"key": "KEY", "y": 2026, "m": 10, "d": 12}) print(r.json())

返回字段

字段说明
solar公历(年/月/日)
lunar农历(text 全文、month_text、day_text、full)
ganzhi干支(年/月/日)
zodiac生肖
constellation星座
week_name星期
jieqi当日节气(若有)
festivals当日节日列表
almanac宜忌 / 冲煞 / 吉神方位
remaining当日剩余可用次数

错误码

code含义
401缺少或无效 api_key
403api_key 已停用
404日期参数不合法
429当日次数已达上限

价格与申请

免费测试
100 次/日,够个人测试与原型开发。
标准授权
99 元/年,100 万次/年,适合个人站长与小程序。
企业授权
定制额度与 SLA,适合商业产品接入。价格详谈。

申请:先联系站长开通(留言反馈 或 商务合作),付费后由站长在后台生成专属 Key。

🎁 节日小礼 · 节日AI定制模型