假期 API

解锁一个庆祝的世界,与假期 API 一起探索!深入挖掘遍及230多个国家的节日数据。回顾过去的欢庆活动或提前规划未来的日历。从公共庆祝活动到宗教仪式和银行假日,这个 API 确保您的应用程序始终与全球的节庆保持同步
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

关于API:

踏上全球庆祝之旅,使用假期API,这是您获取230多个国家、地区和领土的全面假期信息的通行证。这个强大的API不仅提供当前数据,还提供历史假期记录,让用户可以探索往年的节庆活动。无论您是在计划未来还是对过去的庆祝活动感到好奇,假期API都能满足您的需求。

通过深入其庞大的数据集,用户可以发现丰富的假期种类,包括公共庆祝活动、多样的宗教仪式和重要的银行假期。该API涵盖各种类别,确保对全球节庆活动有细致的理解。除了提供日期,该API还提供上下文信息,使开发者能够创建与文化和区域细微差别相呼应的应用程序。

假期API是一个动态工具,供开发者、企业和热衷者将准确、最新的假期信息集成到他们的应用程序中。它的多样性使用户能够提升用户体验、策划活动,或仅仅保持对全球文化和宗教仪式的了解。从热闹的公共节日到庄严的宗教仪式,以及银行关闭的重要日子,这个API是您获取全球假期的全面指南,确保您的应用程序与文化相协调,全球相关。

 

此API接收什么,您的API提供什么(输入/输出)?

返回特定国家和年份的假期条目列表。响应中的每个条目包含假期名称、日期、星期几和假期类型。

 

此API的最常见用例是什么?

  1. 活动策划应用程序:活动策划平台可以利用假期API帮助用户在全球范围内安排和组织活动。通过整合准确的假期数据,这些应用程序可以帮助用户避免时间冲突,确保活动的顺利举行和恰当安排。

  2. 旅游服务:旅游应用程序可以通过整合假期API来优化用户体验,为旅行者提供目的地的实时假期信息。这确保用户意识到地方庆祝活动,让他们能够围绕独特的文化事件和节庆安排旅行。

  3. 人力资源管理系统:人力资源和劳动力管理系统可以使用假期API来简化员工排班。通过考虑公共假期和地区性节庆,这些系统可以自动调整工作日程,帮助企业保持运营效率并遵守当地劳动法。

  4. 金融和银行应用:银行和金融应用可以利用假期API告知用户即将到来的银行假期。这确保客户意识到非工作日,有助于更好的财务规划,并防止与银行交易相关的潜在不便。

  5. 教育工具和平台:教育应用程序可以整合假期API,以增强学生的全球意识。通过包含各种文化和宗教节庆的信息,这些工具可以促进跨文化理解,丰富学生对全球传统的知识,从而有助于更全面和包容的教育。

 

您的计划是否有任何限制?

除了每月的API调用限制外,没有其他限制。

API 文档

端点


返回给定国家和年份的假期条目列表。响应中的每个条目包含假期名称、日期、星期几和假期类型

 

参数

country (必填) - 国家名称或 ISO 3166-2 国家代码(首选)

year (必填) - 日历年份在 2010 和 2030 之间(含)。 注意: 并非所有国家都有数据追溯到 2010 年

type (可选) - 假期类型过滤器。可能的值有:

  • major_holiday - 包括 public_holidaynational_holiday 和 federal_holiday 的组合
  • public_holiday
  • observance
  • national_holiday
  • federal_holiday (仅限美国)
  • season
  • state_holiday
  • optional_holiday
  • clock_change_daylight_saving_time
  • local_holiday
  • united_nations_observance
  • observance_christian
  • bank_holiday
  • common_local_holiday
  • national_holiday_christian
  • christian
  • observance_hebrew
  • jewish_holiday
  • muslim
  • hindu_holiday
  • restricted_holiday
  • official_holiday
  • national_holiday_orthodox
  • local_observance


                                                                            
GET https://www.zylalabs.com/api/3211/%e5%81%87%e6%9c%9f+api/3434/%e8%8e%b7%e5%8f%96%e5%81%87%e6%9c%9f
                                                                            
                                                                        

获取假期 - 端点功能

对象 描述
country [必需] country name or ISO 3166-2 country code (preferred).
year [必需] calendar year between 2010 and 2030 (inclusive).
type 可选 holiday type filter
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        [{"country": "Canada", "iso": "CA", "year": 2025, "date": "2025-09-01", "day": "Monday", "name": "Labour Day", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2025, "date": "2025-05-19", "day": "Monday", "name": "Victoria Day", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2025, "date": "2025-07-01", "day": "Tuesday", "name": "Canada Day", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2025, "date": "2025-04-18", "day": "Friday", "name": "Good Friday", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2025, "date": "2025-12-25", "day": "Thursday", "name": "Christmas Day", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2025, "date": "2025-01-01", "day": "Wednesday", "name": "New Year's Day", "type": "PUBLIC_HOLIDAY"}]
                                                                                                                                                                                                                    
                                                                                                    

获取假期 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/3211/%e5%81%87%e6%9c%9f+api/3434/%e8%8e%b7%e5%8f%96%e5%81%87%e6%9c%9f?country=CA&year=2023&type=public_holiday' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 假期 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

🚀 企业版

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

假期 API FAQs

假期API覆盖全球超过230个国家、地区和领土,提供广泛地点的全面假期数据

是的,该API允许用户访问历史假日数据,使他们能够探索和分析往年的节庆

API定期更新以确保准确性和相关性更新通常实时发生以获取当前假期信息历史数据通过定期更新进行维护

节假日API涵盖了多个类别,包括公共假期宗教节日和银行假期提供了对全球多样庆祝活动的细致理解

用户可以访问未来年份的假期日历,以便在应用程序中进行提前规划和安排

假期API返回指定国家和年份的假期条目列表,包括假期名称、日期、星期几和假期类型

响应数据中的关键字段包括“国家”“iso”(ISO代码)“年份”“日期”“天”“名称”(节假日名称)和“类型”(节假日类型)

响应数据被结构化为一个对象数组,每个对象代表一个假期条目,包含相关字段,如名称、日期和类型

获取假期接口接受三个参数:“country”(必填)、“year”(必填)和“type”(可选)来过滤假期数据

用户可以通过指定“国家”和“年份”来自定义请求,以检索特定地点和时间的假期,并通过使用可选的“类型”参数按假期类别进行过滤

假日API提供有关各种假日类型的信息,包括公众假期、宗教节日、银行假日和各国的季节性庆祝活动

用户可以利用返回的数据通过整合假日信息来增强应用程序用于活动规划、旅行行程、劳动力管理和教育内容,以确保文化相关性

假期API通过定期更新和与可靠来源的验证来维护数据准确性,确保假期信息对用户是最新和可信的

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。

价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]


此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。

定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。

有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]

价格由月度或年度订阅决定,具体取决于所选计划。

API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。

Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。

要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。

要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。

要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。

"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。

是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。

您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。

7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。

当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。

付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。


相关 API


您可能还喜欢