什么是全球节日和纪念日的calendarific?

什么是全球节日和纪念日的calendarific接口？

全球节日和纪念日的calendarific有哪些核心功能？

全球节日和纪念日的calendarific的核心优势是什么？

速度 我们使用基于延迟的 DNS 路由，在 10 毫秒内处理了 90% 以上的请求。	可靠性 我们基于云的自动扩展服务器每天可处理超过 5 亿次 API 查询。	最新信息 我们的数据由多个来源汇总和验证，并定期更新。

在哪些场景会用到全球节日和纪念日的calendarific？

全球假日应用程序接口文档

API 基本 URL

对我们 API 的所有请求都应发送到此端点。以下是应用程序接口支持的端点列表

h

ttps://

calendarific.com/api/v2

应用程序接口端点

以下是我们目前支持的 API 端点列表。请注意，对任何这些端点的请求都将计入您的 API 点击配额。如果您使用的是免费计划，它将计入您的配额。

身份验证

向假日应用程序接口提出的每个请求都需要一个应用程序接口密钥。您的 API 密钥用于通过我们的 API 进行身份验证，应作为api_keyURL 参数提供。

API 密钥可从账户页面获取。如果您不知道自己的 API 密钥，请注册获取免费账户密钥。

?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

api_key应附加到 url 请求中，如下例所示

curl -G https://calendarific.com/api/v2/holidays?api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs

假日应用程序接口端点参数

我们使用 URL 参数对 API 进行查询。有两组参数，即可选参数和必选参数。对于假日 API。国家、年份和api_key是所有假日 API 请求的必填参数。 不包含必填参数的请求将收到错误响应，无法处理。

必填 API 参数

下面是一个请求 2019 年美国所有节假日的示例。请确保将api_key替换为账户页面上的有效值。

curl 'https://calendarific.com/api/v2/holidays?&api_key=baa9dc110aa712sd3a9fa2a3dwb6c01d4c875950dc32vs&country=US&year=2019'

以下是成功执行的简短 API 响应

{ "meta"：{ "code"：200 }, "response"：{ "假日"：[ { "name"："假期名称请点击此处", "description"："假期描述请点击此处"，"日期"：{ "iso"："2018-12-31", "datetime"：{ "year"：2018, "month"：12, "day"：31 } }, "类型"：["纪念类型在此显示"

可选的假日 API 端点参数

我们的 API 有一系列可选参数，允许用户完善返回的结果。请注意，某些可选参数仅限付费用户使用。以下是可选参数的完整列表

注意：可在请求中指定多个类型，以逗号分隔。

高级假日 API 端点参数

我们的 API 支持高级参数，专业版及以上版本的所有用户均可使用这些参数。如果您在没有订阅的情况下使用这些参数，将会收到错误信息。

HTTP 响应代码

每个 API 请求都会返回相应的 HTTP 响应代码，下面列出了这些代码在 API 中的含义

API 错误代码

只要 Calendarific 服务器检测到输入错误，就会返回 HTTP 422 状态代码以及包含错误详细信息的 JSON 对象：

JSON 响应

当有人想调用我们的应用程序接口或浏览我们的网站时，我们会尝试自动检测，并发回适当的 JSON 响应，而不是 HTML。我们这样做是基于已知流行编程语言、工具和框架的用户代理。不过，在无法自动生成 JSON 响应的情况下，我们还有其他一些方法来强制生成 JSON 响应。一种是在 URL 中添加 /json，另一种是将接受标头设置为 application/json：

速率限制

每天免费使用我们的 API 的次数限制为 1,000 次。如果在 24 小时内超过 1,000 次请求，我们将返回 429 HTTP 状态代码。付费计划提供月度限制和可配置的警报。

JSONP/CORS 请求

支持 JSONP 和 CORS，允许您完全在客户端代码中使用 Calendarific。 对于 JSONP，您只需指定回调参数，例如

https://calendarific.com/?callback=callback