万端 API 开发者文档

万端 API 为开发者与 AI Agent 提供开放数据能力，已上线产品：

中国大陆节假日

查询中国大陆任意一天是法定节假日、周末、调休补班还是普通工作日。数据采用国务院及国务院办公厅正式发布的年度安排，响应附带数据集版本号。

• REST 快速开始：通过一条 curl 命令发出第一次请求；
• MCP 快速开始：将节假日查询作为工具接入 AI Agent；
• REST 参考：查看全部端点、参数和响应契约。

REST 与 MCP 均为匿名只读，暂时不需要注册或 API Key 认证。

基础约定

1. 日期一律使用 yyyy-MM-dd 格式。即 ISO 8601 日历日期，不带时间与时区部分。
2. 官方安排未发布时，结果为 UNKNOWN。服务不依据历史规律推测调休，调用方不应将 UNKNOWN 视为工作日或休息日。
3. 错误响应统一采用 RFC 9457 Problem Details。每个错误类型均有独立说明页，见错误说明。

更多内容：产品目录 · 变更记录。