首页›黄历 API 文档
黄历开放 API
农历 · 干支 · 生肖 · 星座 · 宜忌 · 节日 一站式查询接口
接口地址
GET http://jieri.ronhu.com/almanac_api.php?key=你的KEY&y=2026&m=10&d=12y / 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 |
| 403 | api_key 已停用 |
| 404 | 日期参数不合法 |
| 429 | 当日次数已达上限 |