全球节假日与日历API

接入教程

1. 访问The Calendar官网注册获取API密钥。
2. 选择所需日历端点（如节假日、体育赛事）。
3. 使用HTTP GET请求调用API，传入参数如国家代码。
4. 解析返回的JSON数据并集成到您的应用中。

获取美国假日列表

python

import requests

url = "https://api.the-calendar.net/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.the-calendar.net/v1/calendars/sports';
$params = [
    'sport' => 'nba',
    'date' => '2024-05-20',
    '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.the-calendar.net/v1/calendars/financial');
url.searchParams.append('region', 'US');
url.searchParams.append('start_date', '2024-06-01');
url.searchParams.append('end_date', '2024-06-07');
url.searchParams.append('api_key', 'YOUR_API_KEY');

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

常见问题

如何获取API密钥？

请访问 https://the-calendar.net/api/ 并注册免费账户以获取您的API密钥。

API有调用频率限制吗？

是的，免费套餐每分钟最多100次请求，每月最多10,000次请求。如需更高限制，请查看付费计划。

数据更新频率如何？

公共假日数据每年更新一次。体育和金融日历数据每日更新，确保信息的时效性。