API Feiertagskalender Online
Offizielle Feiertage pro europäisches Land — Daten, lokale Bezeichnungen und Typ, vollständige Feiertagsliste pro Land enthalten. Unterstützt durch denselben Nager.Date / OpenHolidaysAPI Service (7-Tage-Cache, lokal berechneter Kosovo-Kalender), der die nakordoni.eu-Feiertagsseite und die Kalenderfaktoren des Vorhersagesystems antreibt. Ein Land gibt ein flaches Objekt zurück; mehrere Länder geben die gleiche Struktur in einer Liste verpackt zurück. upcoming=1 schaltet auf einen flachen, chronologisch sortierten länderübergreifenden Feed um; compare_to schaltet auf einen Vergleich der Übereinstimmungen und Unterschiede zwischen Ländern um, nützlich zur Überprüfung, ob ein Datum auf beiden Seiten eines Grenzübergangs oder nur auf einer Seite ein Feiertag ist.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— Kontingentklasse: cheap
| Parameter | Beschreibung |
|---|---|
country | ISO-2-Ländercode oder durch Kommas getrennte Liste mit bis zu 15 Codes, z. B. PL oder PL,DE,UA. Auslassen für den Standard-Satz (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Ein Code gibt ein flaches Objekt zurück; mehrere Codes eine Liste. |
compare_to | ISO-2-Ländercode oder durch Kommas getrennte Liste zum Vergleich. Schaltet in den Vergleichsmodus: Gibt zurück, welche Feiertage von ALLEN ausgewählten Ländern gemeinsam sind (gleich) und welche nur von einigen (unterschiedlich, mit separaten Listen für enthalten/nicht enthalten pro Datum). Die Parameter upcoming und days wirken hiermit zusammen — sie beschränken gleich/unterschiedlich auf das gewählte Datumsfenster statt das ganze Jahr. |
year | YYYY (Standard: aktuelles Jahr) |
upcoming | 1 = flache Liste der bevorstehenden Feiertage nach Ländern für einige Tage (optional) |
days | Horizont in Tagen für den Modus "zukünftig", 1-180. Ausgelassen oder 0 bedeutet keine Begrenzung — alles, was der zugrundeliegende Dienst sieht, dieses Jahr und nächstes. |
lang | Sprache(n) für das lokalisierte Namensfeld (Standard: en), wie auf der nakordoni.eu-Feiertagskalender-Seite mit 24 Sprachen. Bei nicht gecachten Daten wird der lokale oder englische Name verwendet. Komma-getrennt für bis zu 10 Sprachen, z. B. lang=en,uk,pl — der Name wird aus der ersten angeforderten Sprache übernommen; jedes Fest hat zusätzlich ein names-Objekt mit Sprachcodes als Schlüssel, das alle Übersetzungen enthält. |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
data.countries | The countries compared — the one you asked about and compare_to. |
data.same[] | Days that are a public holiday in BOTH countries: date, weekday, names (one per country). |
data.different[] | Days that are a holiday in one country only: date, weekday, in (where it applies), not_in, names. These are the border-traffic days that catch drivers out. |
data.same_count | Size of same, with different_count for different. |
data.window | Period covered, inside data.year. |
data.mode | Single-country listing or two-country comparison. |
curl "https://nakordoni.eu/api/v1/data/holiday-calendar?country=PL&compare_to=UA&year=2026&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"