API Kalendár sviatkov Online
Oficiálne verejné sviatky v jednotlivých európskych krajinách — dátumy, lokálne názvy a typ, vrátane úplného zoznamu sviatkov pre každú krajinu. Podporované rovnakým služby Nager.Date / OpenHolidaysAPI (7-dňová cache, lokálne vypočítaný kosovský kalendár), ktorý napája stránku kalendára sviatkov nakordoni.eu a kalendárne faktory systému predikcie. Jedna krajina vracia plochý objekt; viacero krajín vracia rovnaký tvar zabalený v zozname. upcoming=1 prepína na plochý, medzi krajinami rozdelený a podľa dátumu zoradený feed; compare_to prepína na porovnanie identické-vs-odlišné medzi krajinami, užitočné na kontrolu, či je dátum sviatok na oboch stranách hraničného prechodu alebo len na jednej.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— trieda kvóty: cheap
| Parameter | Popis |
|---|---|
country | Kód krajiny ISO-2, alebo zoznam až 15 kódov oddelených čiarkou, napr. PL alebo PL,DE,UA. Vynechať pre predvolený súbor (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Jeden kód vráti plochý objekt; viacero kódov vráti zoznam. |
compare_to | Kód ISO-2 krajiny alebo zoznam oddelený čiarkou pre porovnanie. Prepína do porovnávacieho režimu: vracia, ktoré dátumy sviatkov sú spoločné VŠETKÝM vybraným krajinám (rovnaké) a ktoré len niektorým (odlišné, s osobitnými zoznamami v/nie_v pre každý dátum). Parametre upcoming a days sa s tým skladajú — zužujú rovnaké/odlišné na zvolené okno dátumov namiesto celého roka. |
year | YYYY (predvolené: aktuálny rok) |
upcoming | 1 = zoznam nadchádzajúcich sviatkov podľa krajín pre niekoľko dní (nepovinné) |
days | Horizont v dňoch pre režim "nadchádzajúci", 1-180. Vynechané alebo 0 znamená bez obmedzenia — všetko, čo vidí podkladová služba, tento rok a budúci. |
lang | Jazyk(y) pre lokalizované meno poľa (predvolené en), rovnako ako na stránke kalendára sviatkov nakordoni.eu s 24 jazykmi. Pre ne-cacheované dáta sa použije lokálne alebo anglické meno. Zoznam oddelený čiarkou, max. 10 jazykov, napr. lang=en,uk,pl — meno sa berie z prvého požadovaného jazyka; každý sviatok má tiež objekt names s kľúčmi podľa kódov jazykov, ktorý obsahuje všetky preklady. |
Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.
| Pole | Popis |
|---|---|
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"