捷克命名日查询API

接入教程

1. 访问官网注册获取API密钥
2. 使用GET请求调用/svatky接口
3. 在查询参数中传入名字（如jan）
4. API将返回JSON格式的命名日日期
5. 可处理多个名字的批量查询
6. 错误时检查名字拼写和参数格式

使用 Python 查询命名日

python

import requests

# 设置API请求
url = "https://api.example.com/nameday"
params = {
    "name": "Jan",
    "api_key": "YOUR_API_KEY"
}

# 发送请求并处理响应
try:
    response = requests.get(url, params=params)
    response.raise_for_status()
    data = response.json()
    print(f"Name: {data.get('name')}")
    print(f"Nameday Date: {data.get('date')}")
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

使用 PHP 查询命名日

php

<?php
// 设置API请求参数
$name = 'Anna';
$apiKey = 'YOUR_API_KEY';
$url = "https://api.example.com/nameday?name=" . urlencode($name) . "&api_key=" . $apiKey;

// 发送请求并处理响应
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Request failed: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    if (isset($data['date'])) {
        echo "Name: " . htmlspecialchars($data['name']) . "<br>";
        echo "Nameday Date: " . htmlspecialchars($data['date']);
    } else {
        echo "No nameday found for this name.";
    }
}
curl_close($ch);
?>

使用 JavaScript 查询命名日

javascript

// 使用 Fetch API 查询命名日
const name = 'Petr';
const apiKey = 'YOUR_API_KEY';
const url = `https://api.example.com/nameday?name=${encodeURIComponent(name)}&api_key=${apiKey}`;

fetch(url)
    .then(response => {
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        return response.json();
    })
    .then(data => {
        console.log(`Name: ${data.name}`);
        console.log(`Nameday Date: ${data.date}`);
    })
    .catch(error => {
        console.error('Request failed:', error);
    });

常见问题

这个API支持哪些名字格式？

该API支持标准捷克语名字格式，包括常见变体和正式拼写。输入名字时请使用捷克语字符（如带重音的字母）。

如果查询的名字没有对应的命名日怎么办？

如果输入的名字在捷克命名日传统中没有对应的日期，API将返回一个明确的错误信息或空结果，具体取决于API的设计。建议查阅API文档了解具体的错误处理方式。

API调用需要认证吗？

是的，调用此API通常需要使用API密钥进行认证。您需要在请求中包含 'api_key' 参数，并使用有效的密钥。请参考API文档获取详细的认证要求。