# 万端 API 开发者文档

> 面向开发者与 AI Agent 的万端 API 产品文档。

## 文档索引

- [变更记录](https://docs.wanduanapi.com/changelog.md): 公共契约的变化都会记录在本页，包括兼容性影响与调用方需要采取的动作。可在 CI 中订阅本页的 Markdown 镜像，及时感知契约变化。
- [万端 API 开发者文档](https://docs.wanduanapi.com/index.md): 万端 API 为开发者与 AI Agent 提供开放数据能力，已上线产品：
- [日历数据暂时不可用](https://docs.wanduanapi.com/problems/calendar-data-unavailable.md): | 字段 | 值 |
- [日期超出支持范围](https://docs.wanduanapi.com/problems/date-out-of-supported-range.md): | 字段 | 值 |
- [日期区间跨度过大](https://docs.wanduanapi.com/problems/date-range-too-large.md): | 字段 | 值 |
- [错误说明](https://docs.wanduanapi.com/problems.md): REST 错误响应遵循 RFC 9457，响应媒体类型为 `application/problem+json`（HTTP `Content-Type`），除状态码外还包含可执行的修复指引。`type` 是问题的主标识，本站每个 `type` 都有独立的说明页；`code` 是稳定的短码，便于程...
- [服务内部错误](https://docs.wanduanapi.com/problems/internal-error.md): | 字段 | 值 |
- [日期格式无效](https://docs.wanduanapi.com/problems/invalid-date-format.md): | 字段 | 值 |
- [日期区间无效](https://docs.wanduanapi.com/problems/invalid-date-range.md): | 字段 | 值 |
- [方法不允许](https://docs.wanduanapi.com/problems/method-not-allowed.md): | 字段 | 值 |
- [缺少必填参数](https://docs.wanduanapi.com/problems/missing-parameter.md): | 字段 | 值 |
- [资源不存在](https://docs.wanduanapi.com/problems/resource-not-found.md): | 字段 | 值 |
- [数据范围与可信度](https://docs.wanduanapi.com/products/china-calendar/data-and-coverage.md): 节假日数据的准确性直接影响接入方下游业务。本页说明数据来源、支持范围与 `UNKNOWN` 的产生条件，帮助调用方确定合适的消费方式。
- [数据来源](https://docs.wanduanapi.com/products/china-calendar/data-sources.md): 本页列出中国大陆节假日 API 所依据的公开文件。年度通知是对应年度安排的主要依据；补充或调整通知用于说明年度通知之后发生的全国性安排变化；通用制度依据用于解释法定节假日的制度背景。
- [中国大陆节假日](https://docs.wanduanapi.com/products/china-calendar.md): 法定节假日、周末与调休补班相互交织，且每年随国务院文件调整，人工维护成本高。本 API 将这些规则封装为一次查询：传入日期，返回权威结论。数据采用国务院及国务院办公厅正式发布的年度安排，不依据历史规律推测。
- [MCP 快速开始](https://docs.wanduanapi.com/products/china-calendar/mcp/quickstart.md): 如果调用方是 AI Agent 或自动化工作流，可以将节假日查询作为 MCP 工具接入。
- [REST 快速开始](https://docs.wanduanapi.com/products/china-calendar/rest/quickstart.md): 本页引导您完成第一次 REST 请求，并解释响应结构。
- [REST 参考](https://docs.wanduanapi.com/products/china-calendar/rest/reference.md): 本页提供中国大陆节假日 REST API 的人工可读契约，包含端点、请求参数、响应字段、枚举值和错误响应。所有端点的基础地址为：
- [产品目录](https://docs.wanduanapi.com/products.md): 万端 API 按产品组织文档、REST 路径、MCP 工具和错误类型。每个产品有独立的路径前缀与 `operationCode`，互不共享未声明的规则。