> 完整文档索引见 [llms.txt](https://docs.wanduanapi.com/llms.txt)。本站每个文档页均提供 Markdown 镜像；当前页面的 Markdown 版本见 [此处](https://docs.wanduanapi.com/products/china-calendar.md)。

# 中国大陆节假日

法定节假日、周末与调休补班相互交织，且每年随国务院文件调整，人工维护成本高。本 API 将这些规则封装为一次查询：传入日期，返回权威结论。数据采用国务院及国务院办公厅正式发布的年度安排，不依据历史规律推测。

## 能力

- 查询任意一天的状态：法定节假日、调休补班、周末或普通工作日，包含关联节日信息；
- 一次查询最长 366 天的逐日状态，适用于排班与日历同步场景；
- 统计区间内的工作日、休息日和未知安排日期；
- 查询从指定日期起的下一个法定节假日。

## 适用场景

- **排班、考勤与薪资系统**：调休补班是冲突点，调用 API 直接拿到权威数据；
- **日历类产品**：逐日状态与节日名称可直接用于渲染日历视图；
- **AI Agent 与自动化工作流**：通过 MCP 接入后，模型回答节假日问题时依据接口返回的权威数据，而非训练语料中可能过时的安排。

## 下一步

→ [REST 快速开始](./rest/quickstart.md)：发出第一个请求并理解响应结构

→ [MCP 快速开始](./mcp/quickstart.md)：将工具接入 AI Agent

→ [REST 参考](./rest/reference.md)：全部端点与 operationCode

→ [数据范围与可信度](./data-and-coverage.md)：数据来源与支持范围

## 基础地址

```text
https://api.wanduanapi.com
```

REST 与 MCP 均为匿名只读查询，无需注册或 API Key。