跳到主要内容

中国大陆节假日

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

能力

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

适用场景

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

下一步

REST 快速开始:发出第一个请求并理解响应结构

MCP 快速开始:将工具接入 AI Agent

REST 参考:全部端点与 operationCode

数据范围与可信度:数据来源与支持范围

基础地址

https://api.wanduanapi.com

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