提供中国法定节假日与调休安排的免费查询接口，返回 JSON 格式，无需注册、无需密钥、不限调用次数，供开发者在自己的项目、脚本、小程序中直接使用。使用时请在你的项目文档或页面中注明数据来源为 jieri8.com。

请求方式

GET https://www.jieri8.com/api/holidays.php?year=2026

请求参数

参数	类型	必填	说明
year	int	否	查询的年份，默认为当前年份，支持范围 2001-2100（仅国务院已正式公布的年份有数据）

返回字段

字段	说明
code	0 表示成功，1 表示失败（如年份暂无数据）
year	查询的年份
count	该年份节假日数量
data	节假日数组，每项包含 name（名称）、start/end（放假起止日期）、rest_days（放假日列表）、work_days（调休上班日列表）

返回示例

{
  "code": 0,
  "year": 2026,
  "count": 7,
  "data": [
    {
      "name": "元旦节",
      "rest_days": ["2026-01-01","2026-01-02","2026-01-03"],
      "work_days": ["2026-01-04"],
      "start": "2026-01-01",
      "end": "2026-01-03"
    }
  ]
}

示例代码

JavaScript：

fetch('https://www.jieri8.com/api/holidays.php?year=2026')
  .then(res => res.json())
  .then(data => console.log(data));

Python：

import requests
r = requests.get('https://www.jieri8.com/api/holidays.php', params={'year': 2026})
print(r.json())

其他方式

如果你想在自己的日历 App 里直接同步节假日，不需要写代码调用接口，可以用日历订阅（ICS），导入后自动更新。