API 概述
中国节假日 API 提供准确、及时的中国法定节假日数据，支持按年份或特定日期查询节假日信息，包括节假日名称、日期以及是否为休息日的标识。 该 API 适用于各种需要节假日信息的应用场景，如日程安排、考勤系统、节假日提醒等。
数据准确
基于官方发布的节假日安排，确保数据的准确性和权威性。
响应迅速
优化的接口设计和高效的数据处理，确保快速响应查询请求。
易于集成
简单的 GET 请求方式，标准化的 JSON 响应格式，便于快速集成到各类应用。
在线查询
API 特性
多格式日期支持
支持多种日期格式，包括 YYYY-MM-DD、YYYY/MM/DD、YYYY/M/D 等格式。
详细节假日信息
返回节假日名称、具体日期以及是否为休息日（true 表示放假，false 表示调休）。
完整年度数据
通过年份查询可获取该年度所有法定节假日的完整信息，方便批量处理和展示。
标准化 JSON 响应
响应数据采用标准 JSON 格式，结构清晰，便于解析和使用。
友好的错误提示
当查询参数无效或数据不存在时，返回清晰的错误信息，便于问题排查。
跨平台兼容
适用于各种开发环境和平台，包括 Web、移动应用、桌面应用等。
API 文档
基本信息
请求方式
GET
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| year | 整数 | 否 | 查询年份，如：2025 |
| date | 字符串 | 否 | 查询日期，支持格式：YYYY-MM-DD、YYYY/MM/DD、YYYY/M/D |
返回格式
年份查询成功响应
{
"year": "2025",
"days": [
{
"name": "元旦",
"date": "2025-01-01",
"isOffDay": true
},
...
]
}
日期查询成功响应
{
"name": "清明节",
"date": "2025-04-04",
"isOffDay": true
}
错误响应
{
"error": "错误信息"
}