{
"country": "ES",
"state": "MD",
"year": 2026,
"count": 14,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day",
"type": "public",
"substitute": false
},
{
"date": "2026-01-06",
"name": "Epiphany",
"type": "public",
"substitute": false
},
{
"date": "2026-04-02",
"name": "Maundy Thursday",
"type": "public",
"substitute": false
},
{
"date": "2026-04-03",
"name": "Good Friday",
"type": "public",
"substitute": false
},
{
"date": "2026-05-01",
"name": "Labour Day",
"type": "public",
"substitute": false
},
{
"date": "2026-05-02",
"name": "Día de la Comunidad de Madrid",
"type": "public",
"substitute": false
},
{
"date": "2026-08-15",
"name": "Assumption",
"type": "public",
"substitute": false
},
{
"date": "2026-10-12",
"name": "Fiesta Nacional de España",
"type": "public",
"substitute": false
},
{
"date": "2026-11-01",
"name": "All Saints' Day",
"type": "public",
"substitute": false
},
{
"date": "2026-11-02",
"name": "All Saints' Day (substitute day)",
"type": "public",
"substitute": true
},
{
"date": "2026-12-06",
"name": "Día de la Constitución Española",
"type": "public",
"substitute": false
},
{
"date": "2026-12-07",
"name": "Día de la Constitución Española (substitute day)",
"type": "public",
"substitute": true
},
{
"date": "2026-12-08",
"name": "Immaculate Conception",
"type": "public",
"substitute": false
},
{
"date": "2026-12-25",
"name": "Christmas Day",
"type": "public",
"substitute": false
}
],
"source": "date-holidays (CC BY 3.0 data)"
}
curl --location --request GET 'https://zylalabs.com/api/14211/public+holidays+api+-+100+plus+countries/35278/holidays+of+a+year?country=ES&year=2026&state=MD&types=public&lang=en' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "US",
"date": "2026-12-25",
"isHoliday": true,
"holidays": [
{
"name": "Christmas Day",
"type": "public"
}
],
"source": "date-holidays (CC BY 3.0 data)"
}
curl --location --request GET 'https://zylalabs.com/api/14211/public+holidays+api+-+100+plus+countries/35279/is+it+a+holiday?country=US&date=2026-12-25' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "DE",
"states": {
"BB": "Brandenburg",
"BE": "Berlin",
"BW": "Baden-Württemberg",
"BY": "Bayern",
"HB": "Hansestadt Bremen",
"HE": "Hessen",
"HH": "Hansestadt Hamburg",
"MV": "Mecklenburg-Vorpommern",
"NI": "Niedersachsen",
"NW": "Nordrhein-Westfalen",
"RP": "Rheinland-Pfalz",
"SH": "Schleswig-Holstein",
"SL": "Saarland",
"SN": "Sachsen",
"ST": "Sachsen-Anhalt",
"TH": "Thüringen"
}
}
curl --location --request GET 'https://zylalabs.com/api/14211/public+holidays+api+-+100+plus+countries/35280/countries+and+regions?country=DE' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 公共假期API - 超过100个国家 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
每个端点返回与100多个国家及其地区的公共假期和银行假期相关的数据 "一年的假期"端点提供指定年份的假期列表 "这一天是节假吗"端点检查特定日期是否为假期 "国家和地区"端点列出可用国家及其细分区域
关键字段包括“国家”“州”“年份”“计数”“假期”(详细信息如“日期”“名称”“类型”和“替代”)以及“isHoliday”用于日期检查 这些字段提供有关假期及其特征的基本信息
主要参数包括“国家”“州”和“年份”用于“每年的假期”端点,以及“日期”用于“今天是假期吗?”端点 用户可以指定这些参数以根据他们的需求定制数据请求
响应数据以JSON格式结构化 例如 "一年的假期" 端点返回一个包含国家代码 州 年份 假期数量和一个假期对象数组的对象 每个假期对象详细说明了日期 名称 类型和替代状态
数据来源于date-holidays(CC BY 3.0)这确保了信息是公开可用的并且可以自由使用同时也保持了关于数据来源的透明度
典型的使用案例包括围绕假期规划活动 开发需要假期意识的应用程序 以及为企业和旅行者提供本地化的假期信息 这些数据可以通过将假期意识融入各种服务来增强用户体验
用户可以通过解析JSON响应来提取相关的假期信息,从而利用返回的数据。例如,他们可以检查特定日期是否是假期,并在应用程序中显示本地化的假期名称,增强用户参与感和功能性
数据准确性通过定期更新和对可靠来源的检查来维护 API 利用社区驱动的方法,允许进行更正和增强,确保用户获得最准确的假日信息