# 节假日查询指南总目录
> 接口 894 · 免费 · POST/GET · 返回 JSON · 适用人群：全部读者 · 阅读时间：约 3 分钟
## 一句话速览
**节假日查询（apiCode=894）** 是易源官方自营的免费接口，提供节假日、调休日、国际日及传统节日简介查询，适用于日程安排、证券投资、日历应用等场景。含 3 个接入点：894-4 假日列表（按年）、894-6 节假日查询（按日判定）、894-7 调休日列表（补班日）。支持 MCP 与 OpenAPI 3.0 集成。
## 分层文章目录（共 12 篇）
### 入门层
1. [节假日查询：5 分钟接入，从注册到拿到全年放假安排](https://www.showapi.com/guides/holiday-query-quickstart-894) — 注册→AppKey→首次调用 894-4，三语言最小示例。
2. [节假日查询返回字段全解：ret_code 与 type(1/2/3) 及三接入点结构一文读懂](https://www.showapi.com/guides/holiday-query-response-codes-894) — 三接入点字段对照，ret_code 类型坑与 type 枚举。
### 场景实战层
3. [节假日查询：某天到底放不放假？894-6 单日判定接入指南](https://www.showapi.com/guides/holiday-query-day-check-894) — 用 type(1/2/3) 判定工作日/周末/节假日。
4. [节假日查询：一键生成全年放假日历，894-4 假日列表实战](https://www.showapi.com/guides/holiday-query-year-list-894) — 拉全年数据拼"放假+补班"二维日历。
5. [节假日查询：调休上班日怎么算？894-7 调休日列表查询实战](https://www.showapi.com/guides/holiday-query-makeup-days-894) — 查全年补班日，inverse_days 对象结构。
6. [节假日查询：节日简介与农历日期怎么拿？needDesc 与 h 字段实战](https://www.showapi.com/guides/holiday-query-festival-intro-894) — needDesc 触发 h 数组拿简介与农历。
### 技术深挖层
7. [节假日查询：免费接口也要省调用，节假日数据缓存策略设计](https://www.showapi.com/guides/holiday-query-cache-894) — 数据一年变一次，Redis 整年缓存与次年预热。
8. [节假日查询：为什么只能查 2018 年起？数据覆盖范围与边界说明](https://www.showapi.com/guides/holiday-query-data-range-894) — 2018 起的数据范围与次年更新窗口。
### 行业方案层
9. [节假日查询：日历 / 日程应用如何集成？从数据到 UI 的全链路设计](https://www.showapi.com/guides/holiday-query-schedule-app-894) — 日历/排班应用的数据→渲染→更新全链路。
10. [节假日查询：证券交易休市怎么对齐？金融场景下的节假日应用](https://www.showapi.com/guides/holiday-query-stock-securities-894) — 法定节假日维度的休市对齐与边界。
### 生态集成层
11. [节假日查询：通过 MCP 协议在 AI 客户端里直接调用](https://www.showapi.com/guides/holiday-query-mcp-894) — Cherry Studio/ChatBox 等 MCP 客户端配置。
12. [节假日查询：导入 Postman / Swagger，用 OpenAPI 文档管理接口](https://www.showapi.com/guides/holiday-query-openapi-894) — OpenAPI 3.0 导入 API 工具做治理。
## 相关资源表
| 资源 | 地址 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/894 |
| 接入点 894-4（假日列表） | https://www.showapi.com/apiGateway/view/894/4 |
| 接入点 894-6（节假日查询） | https://www.showapi.com/apiGateway/view/894/6 |
| 接入点 894-7（调休日列表） | https://www.showapi.com/apiGateway/view/894/7 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/894.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/894.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费 API 档位说明 | https://www.showapi.com/island/free-api |
## 阅读建议
- **第一次用**：从《5 分钟接入》开始，跑通 894-4 拿全年放假。
- **写代码前**：先读《返回字段全解》，避开 ret_code 类型与字段结构坑。
- **做产品**：按"单日判定 → 全年日历 → 缓存 → 行业方案"顺序深入。
- **接 AI / 治理**：看《MCP 接入》与《OpenAPI 导入》两篇。
