# 万端 API 开发者文档

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

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [变更记录](https://docs.zkogow.top/changelog.md): - 发布中国大陆日历 REST 与 MCP 开发者文档；
- [万端 API 开发者文档](https://docs.zkogow.top/index.md): 万端 API 面向开发者与 AI Agent 提供可演进的开放能力。当前首个产品是中国大陆节假日、调休与工作日计算，支持 REST 和 MCP。
- [日历数据暂时不可用](https://docs.zkogow.top/problems/calendar-data-unavailable.md): | 字段 | 值 |
- [日期超出支持范围](https://docs.zkogow.top/problems/date-out-of-supported-range.md): | 字段 | 值 |
- [日期区间跨度过大](https://docs.zkogow.top/problems/date-range-too-large.md): | 字段 | 值 |
- [错误说明](https://docs.zkogow.top/problems.md): REST 错误响应遵循 RFC 9457，媒体类型为 `application/problem+json`。其中 `type` 是可解引用的主语义标识，`code` 是便于程序分支的稳定短码；调用方应优先按 `type` 理解错误，并可按 `code` 做本地映射。
- [服务内部错误](https://docs.zkogow.top/problems/internal-error.md): | 字段 | 值 |
- [日期格式无效](https://docs.zkogow.top/problems/invalid-date-format.md): | 字段 | 值 |
- [日期区间无效](https://docs.zkogow.top/problems/invalid-date-range.md): | 字段 | 值 |
- [方法不允许](https://docs.zkogow.top/problems/method-not-allowed.md): | 字段 | 值 |
- [缺少必填参数](https://docs.zkogow.top/problems/missing-parameter.md): | 字段 | 值 |
- [资源不存在](https://docs.zkogow.top/problems/resource-not-found.md): | 字段 | 值 |
- [数据范围与可信度](https://docs.zkogow.top/products/china-calendar/data-and-coverage.md): 全国统一节假日数据以国务院及国务院办公厅正式发布的年度安排为权威来源。数据集经过校验、版本化导入和发布，响应中的 `datasetVersion` 标识实际使用的版本。
- [中国大陆日历](https://docs.zkogow.top/products/china-calendar.md): 中国大陆日历 API 提供全国统一的节假日、调休补班、周末和工作日查询。数据只采用国务院及国务院办公厅已正式发布的年度安排。
- [MCP 快速开始](https://docs.zkogow.top/products/china-calendar/mcp/quickstart.md): 中国大陆日历通过无状态 Streamable-HTTP MCP Server 提供与 REST 一致的业务语义。
- [REST 快速开始](https://docs.zkogow.top/products/china-calendar/rest/quickstart.md): REST 接口以 `/v1` 为产品契约前缀。日期参数必须使用 ISO 8601 `yyyy-MM-dd`。
- [REST 参考](https://docs.zkogow.top/products/china-calendar/rest/reference.md): 中国大陆日历的机器可读契约由产品级 OpenAPI 规范定义：
- [产品目录](https://docs.zkogow.top/products.md): 万端 API 按产品组织 REST、MCP、数据边界与变更记录。每个产品拥有独立的文档路径和稳定的 OpenAPI operationCode。