假期 API 与检查假期 API：选择哪个？

在当今全球化的世界中，了解不同国家的公共假期和非公共假期对于企业、旅行者和活动策划者至关重要。两个提供此功能的流行 API 是检查假期 API 和我们将在本文中比较的另一个 API。本文将深入比较这些 API，重点关注它们的功能、性能、可扩展性和使用案例，以帮助您做出明智的决定，选择适合您需求的 API。

检查假期 API 概述

检查假期 API 旨在帮助用户跟踪全球的公共假期和非公共假期。它支持大量国家的列表，允许用户检查特定地区庆祝的假期。该 API 检索给定国家的全面假期列表，涵盖当前年份、未来年份和过去的年份。它支持全球 195 个国家，使其成为全球假期跟踪的强大解决方案。

要使用检查假期 API，您只需传递所选国家，选择年份，并可选地指定要检查的月份和日期。该 API 将返回假期的日期、名称、是否为公共假期以及将庆祝的星期几。

检查假期 API 的主要特性和功能

获取假期

“获取假期”功能允许用户在指定时间段内检索所选国家的假期。此功能需要两个参数：countryCode（例如，US）和 year（例如，2019）。此功能对于需要围绕假期进行计划的企业和个人至关重要。

[
{
"date": "2023-01-01",
"localName": "New Year's Day",
"name": "New Year's Day",
"countryCode": "GB",
"fixed": false,
"global": false,
"counties": ["GB-NIR"],
"launchYear": null,
"type": "Public"
},
{
"date": "2023-01-02",
"localName": "New Year's Day",
"name": "New Year's Day",
"countryCode": "GB",
"fixed": false,
"global": false,
"counties": ["GB-ENG", "GB-WLS"],
"launchYear": null,
"type": "Public"
}
]

在此响应中，每个假期条目包括：

date：假期的日期。
localName：假期在当地语言中的名称。
name：假期的英文名称。
countryCode：国家的 ISO 代码。
fixed：指示假期是固定的还是可移动的。
global：指示假期是否在全球庆祝。
counties：列出在该国观察假期的特定地区。
launchYear：假期首次观察的年份。
type：假期的类型（例如，公共假期、观察日）。

可用国家

此功能允许用户检索 API 支持的所有可用国家的列表。这是一个简单的端点，为希望了解其国家是否受支持的用户提供基本信息。

{
"message": "Available Countries",
"total": 233,
"countriesAvailable": [
"afghanistan",
"albania",
"algeria",
"american-samoa",
"andorra",
"angola",
"anguilla",
"antigua-and-barbuda",
"argentina",
"armenia",
"aruba",
"australia",
"austria",
"azerbaijan",
"bahrain",
"bangladesh",
"barbados",
"belarus",
"belgium",
"belize",
"benin",
"bermuda",
"bhutan",
"bolivia",
"bosnia",
"botswana",
"brazil",
"british-virgin-islands",
"brunei",
"bulgaria",
"burkina-faso",
"burundi",
"cape-verde",
"cambodia",
"cameroon",
"canada",
"cayman-islands",
"central-african-republic",
"chad",
"chile",
"china",
"colombia",
"comores",
"republic-of-the-congo",
"dr-congo",
"cook-islands",
"costa-rica",
"ivory-coast",
"croatia",
"cuba",
"curacao",
"cyprus",
"czech",
"denmark",
"djibouti",
"dominica",
"dominican-republic",
"timor-leste",
"ecuador",
"egypt",
"el-salvador",
"guineaecuatorial",
"eritrea",
"estonia",
"eswatini",
"ethiopia",
"falkland-islands",
"faroe-islands",
"fiji",
"finland",
"france",
"french-guiana",
"french-polynesia",
"gabon",
"gambia",
"georgia",
"germany",
"ghana",
"gibraltar"
]
}

此响应提供：

message：确认请求成功的消息。
total：可用国家的总数。
countriesAvailable：一个支持该 API 的国家名称数组。

按国家的假期

“按国家的假期”功能允许用户输入国家名称和可选年份，以检索详细的假期信息。这对于希望专注于特定国家和年份的用户特别有用。

{
"country": "denmark",
"year": 2024,
"holidays": [
{
"date": "Jan 1 - Monday",
"name": "New Year's Day",
"type": "National Holiday",
"details": ""
},
{
"date": "Jan 14 - Sunday",
"name": "Accession of King Frederik X",
"type": "Observance",
"details": ""
}
]
}

此响应包括：