Calendarific

接入教程

1. 访问Calendarific官网注册账户获取API密钥。
2. 在您的项目中引入API端点，例如：https://calendarific.com/api/v2/holidays。
3. 设置请求参数，如国家代码、年份和月份（可选）。
4. 发送包含API密钥的GET请求获取节假日数据。
5. 解析返回的JSON响应，提取所需的节假日信息。
6. 根据需要处理错误响应，确保API调用稳定可靠。

Python调用示例

python

import requests

url = "https://api.calendarific.com/v1/holidays"
params = {
    "api_key": "YOUR_API_KEY",
    "country": "US",
    "year": 2023
}

response = requests.get(url, params=params)
data = response.json()
print(data)

PHP调用示例

php

<?php
$url = "https://api.calendarific.com/v1/holidays";
$params = [
    "api_key" => "YOUR_API_KEY",
    "country" => "US",
    "year" => 2023
];

$ch = curl_init($url . '?' . http_build_query($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>

JavaScript调用示例

javascript

const url = 'https://api.calendarific.com/v1/holidays';
const params = new URLSearchParams({
    api_key: 'YOUR_API_KEY',
    country: 'US',
    year: 2023
});

fetch(`${url}?${params}`)
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

常见问题

如何获取API密钥？

请访问Calendarific官方网站注册账户，在开发者控制台中创建项目即可获取API密钥。免费套餐有一定调用次数限制。

API支持哪些查询参数？

主要参数包括国家代码（country）、年份（year）、月份（month）、日期（day）等。还可通过类型（type）筛选特定类型的节假日。

API的请求频率限制是多少？

免费套餐通常为每月1000次请求，具体限制请查阅官方文档的最新说明。超过限制后请求可能会被拒绝。