China Public Holiday & Multilingual Calendar API

Multilingual Chinese holiday & calendar API: holiday, workday, lunar, zodiac, 24 solar terms. Support zh/en/ja/ko/vi/es/fr/de.

原始信息汇总

China Public Holiday & Multilingual Calendar API 数据集概述

数据集名称

China Public Holiday & Multilingual Calendar API

核心功能

• 提供稳定、低延迟、国际化的日历服务。
• 日期综合查询：农历、生肖、星座、天干地支、黄历、节气。
• 指定日期节假日查询（100%官方中国公共节假日）。
• 中国年度全国节假日列表（每年更新）。
• 工作日判断与工作日计算（包含调休日）。
• 24节气列表及当前节气查询。
• 支持8种语言：zh（中文）、en（英文）、ja（日文）、ko（韩文）、vi（越南文）、es（西班牙文）、fr（法文）、de（德文）。

适用场景

• 全球应用与跨境电商平台。
• 日历与日程安排工具。
• 人力资源与考勤系统。
• 金融与会计软件。
• 中国文化学习应用。
• 任何需要中国日历/节假日数据的项目。

API端点概览

方法	端点	描述	是否需要认证
GET	/public-china-holiday/date	综合日期信息（农历、生肖、黄历、节气）	是
GET	/public-china-holiday/holiday/query	检查指定日期是否为公共节假日	是
GET	/public-china-holiday/holiday/list	获取指定年份的完整节假日列表	是
GET	/public-china-holiday/workday	检查指定日期是否为工作日（包含调休日）	是
GET	/public-china-holiday/workday/calculate	计算工作日（偏移或计数）	是
GET	/public-china-holiday/solar-term/list	获取指定年份的24节气列表	是
GET	/public-china-holiday/solar-term/current	获取当前节气信息	是
POST	/public-china-holiday/holiday/refresh	刷新节假日缓存（仅管理员）	是

快速开始

1. 认证

所有业务端点都需要 X-RapidAPI-Key 请求头。

2. 通用参数

参数	类型	是否必需	描述
date	string	是	日期，格式为 YYYY-MM-DD
year	integer	是	年份（1900-2100）
lang	string	否	输出语言（默认：zh，支持8种语言）

3. 请求示例（日期查询）

curl --request GET --url https://china-holiday-api.vercel.app/public-china-holiday/date?date=2025-10-01&lang=en --header X-RapidAPI-Key: YOUR_RAPIDAPI_KEY

服务特性

• 全球CDN与高可用性：部署于Vercel，全球低延迟，99.9%正常运行时间。
• 安全可靠：HTTPS加密，API密钥认证，速率限制。

订阅计划

• BASIC: $0.00 / 月
• PRO: $2.99 / 月
• ULTRA: $7.99 / 月
• MEGA: $19.99 / 月

搜集汇总

背景与挑战

背景概述

该数据集提供中国公共假日和多语言日历API，涵盖假日、工作日、农历、生肖及24节气等信息，并支持包括中文、英文、日语在内的多种语言。