节假日历史数据API

接入教程

1. 访问官网注册账号获取API密钥
2. 选择目标国家代码和查询日期范围
3. 调用节假日查询接口获取历史数据
4. 解析返回的JSON格式假日信息
5. 将数据集成到您的应用程序中
6. 根据需要进行缓存优化

Python 示例：查询节假日

python

import requests

url = 'https://holidayapi.com/v1/holidays'
params = {
    'key': 'YOUR_API_KEY',
    'country': 'US',
    'year': '2023'
}
response = requests.get(url, params=params)
data = response.json()
if response.status_code == 200:
    holidays = data.get('holidays', [])
    for holiday in holidays:
        print(f"{holiday['date']}: {holiday['name']}")
else:
    print(f"Error: {data.get('error', 'Unknown error')}")

PHP 示例：获取节假日数据

php

<?php
$apiKey = 'YOUR_API_KEY';
$url = 'https://holidayapi.com/v1/holidays?' . http_build_query([
    'key' => $apiKey,
    'country' => 'CN',
    'year' => '2023'
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if ($data && isset($data['holidays'])) {
    foreach ($data['holidays'] as $holiday) {
        echo $holiday['date'] . ': ' . $holiday['name'] . "\n";
    }
} else {
    echo 'Error fetching holiday data.';
}
?>

JavaScript 示例：检索节假日

javascript

const apiKey = 'YOUR_API_KEY';
const url = `https://holidayapi.com/v1/holidays?key=${apiKey}&country=GB&year=2023`;

fetch(url)
    .then(response => response.json())
    .then(data => {
        if (data.holidays) {
            data.holidays.forEach(holiday => {
                console.log(`${holiday.date}: ${holiday.name}`);
            });
        } else {
            console.log('Error:', data.error || 'Unknown error');
        }
    })
    .catch(error => console.error('Request failed:', error));

常见问题

这个 API 支持哪些国家的节假日数据？

Holidays API 覆盖全球大多数国家和地区，包括美国、中国、英国、日本等。具体支持的国家列表可在 API 文档中查询，通常通过国家代码（如 US、CN）指定。

API 调用有频率限制吗？如何获取 API 密钥？

是的，API 通常有调用频率限制，具体限制取决于您的订阅计划。免费层可能有每日调用次数限制。API 密钥需在官方网站注册账户后，在仪表板中生成。请妥善保管密钥，避免泄露。

数据更新频率如何？是否包含历史节假日？

节假日数据会定期更新，以反映各国最新的法定假日调整。API 提供历史数据查询，通常可检索多年历史，具体年份范围请参考文档。数据来源可靠，确保准确性。