CalDays

接入教程

1. 访问CalDays网站注册获取API密钥
2. 查看文档了解可用端点和参数
3. 使用GET请求调用节假日查询接口
4. 处理返回的JSON格式节假日数据
5. 根据需要缓存数据优化性能

查询指定国家的节假日

python

import requests

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

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

检查指定日期是否为节假日

php

<?php

$url = "https://api.example.com/v1/check";
$params = [
    'country' => 'CN',
    'date' => '2024-10-01',
    'api_key' => 'YOUR_API_KEY'
];

$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

const url = new URL('https://api.example.com/v1/holidays/bulk');
const params = {
    countries: ['US', 'GB', 'JP'],
    year: 2024,
    api_key: 'YOUR_API_KEY'
};

Object.keys(params).forEach(key => {
    if (Array.isArray(params[key])) {
        params[key].forEach(val => url.searchParams.append(key, val));
    } else {
        url.searchParams.append(key, params[key]);
    }
});

fetch(url)
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));

常见问题

CalDays API 是否免费使用？

CalDays API 提供免费套餐，包含每月一定次数的请求。如需更高限制或高级功能，可升级至付费计划。详细信息请访问官网。

API 支持哪些数据格式？

API 默认返回 JSON 格式数据，也支持通过请求头指定返回 XML 格式。所有响应均包含标准 HTTP 状态码。

如何获取 API 密钥？

访问 CalDays 官网注册账户，即可在控制台生成和管理 API 密钥。免费套餐无需绑定支付方式。