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

# 万端 API 开发者文档

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

## 中国大陆节假日

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

- [REST 快速开始](./products/china-calendar/rest/quickstart.md)：通过一条 `curl` 命令发出第一次请求；
- [MCP 快速开始](./products/china-calendar/mcp/quickstart.md)：将节假日查询作为工具接入 AI Agent；
- [REST 参考](./products/china-calendar/rest/reference.md)：查看全部端点、参数和响应契约。

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

## 基础约定

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

更多内容：[产品目录](./products.md) · [变更记录](./changelog.md)。