节假日API

接入教程

1. 注册AbstractAPI账号并获取API密钥
2. 查看文档了解可用参数（如国家、年份）
3. 使用HTTP请求调用接口获取节假日数据
4. 解析返回的JSON格式数据
5. 将数据集成到您的应用程序中
6. 根据需要进行错误处理和缓存优化

Python查询节假日

python

import requests

url = "https://holidays.abstractapi.com/v1/"
params = {
    "api_key": "YOUR_API_KEY",
    "country": "US",
    "year": 2024,
    "month": 12,
    "day": 25
}
response = requests.get(url, params=params)
if response.status_code == 200:
    holidays = response.json()
    print(f"Found {len(holidays)} holiday(s)")
    for holiday in holidays:
        print(f"- {holiday.get('name')} ({holiday.get('date')})")
else:
    print(f"Error: {response.status_code}")

PHP获取节假日数据

php

<?php
$apiKey = 'YOUR_API_KEY';
$url = 'https://holidays.abstractapi.com/v1/';
$queryParams = [
    'api_key' => $apiKey,
    'country' => 'CN',
    'year' => 2024
];
$fullUrl = $url . '?' . http_build_query($queryParams);
$ch = curl_init($fullUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response === false) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    $holidays = json_decode($response, true);
    echo "Found " . count($holidays) . " holiday(s)\n";
    foreach ($holidays as $holiday) {
        echo "- " . $holiday['name'] . " (" . $holiday['date'] . ")\n";
    }
}
curl_close($ch);
?>

JavaScript调用节假日API

javascript

const apiKey = 'YOUR_API_KEY';
const url = new URL('https://holidays.abstractapi.com/v1/');
const params = {
    api_key: apiKey,
    country: 'GB',
    year: 2024,
    month: 1
};
Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

fetch(url)
    .then(response => {
        if (!response.ok) {
            throw new Error(`HTTP error! Status: ${response.status}`);
        }
        return response.json();
    })
    .then(data => {
        console.log(`Found ${data.length} holiday(s)`);
        data.forEach(holiday => {
            console.log(`- ${holiday.name} (${holiday.date})`);
        });
    })
    .catch(error => {
        console.error('Error fetching holidays:', error);
    });

常见问题

这个节假日API支持哪些国家或地区？

该API覆盖全球超过230个国家及地区，包括中国、美国、英国、日本、印度等主要国家，并提供各国家级的公共节假日数据。用户可通过国家代码参数（如CN代表中国）查询指定区域的节假日信息。

API返回的数据包含哪些字段？

返回的节假日数据通常包含以下核心字段：节假日名称（name）、日期（date）、所属国家或地区（country）、节假日类型（类型可能包括国家级、宗教性、纪念日等）。部分数据还可能包含本地化名称、是否为公共假期等扩展信息。

调用API时有哪些常见的参数？

常见请求参数包括：api_key（您的API密钥）、country（国家代码，如US）、year（年份，如2024）、month（月份，1-12）、day（日期，1-31）。用户可组合这些参数来筛选特定日期、国家或时间范围的节假日数据。