API Kalendář svátků Online
Oficiální státní svátky podle evropských zemí — data, místní názvy a typ, včetně úplného seznamu svátků každé země. Podporováno stejnou službou Nager.Date / OpenHolidaysAPI (7denní cache, lokálně vypočítaný kalendář Kosova), která napájí stránku s kalendářem svátků na nakordoni.eu a kalendářní faktory predikčního systému. Jedna země vrací plochý objekt; více zemí vrací stejnou strukturu zabalenu v poli. upcoming=1 přepíná na plochý, podle data seřazený cross-country feed; compare_to přepíná na porovnání shody-vs-rozdílu mezi zeměmi, užitečné pro ověření, zda je určité datum státním svátkem na obou stranách hraničního přechodu nebo pouze na jedné.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
country | ISO-2 kód země, nebo seznam až 15 kódů oddělených čárkou, např. PL nebo PL,DE,UA. Vynechat pro výchozí sadu (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Jeden kód vrátí plochý objekt; několik kódů vrátí seznam. |
compare_to | Kód ISO-2 země nebo seznam oddělený čárkami pro porovnání. Přepíná do režimu porovnávání: vrací, které sváteční dny jsou společné VŠEM vybraným zemím (stejné) a které pouze některým (odlišné, s oddělenými seznamy v/ne_v pro každé datum). Parametry upcoming a days s tím spolupracují — zužují stejné/odlišné na zvolené okno dat místo celého roku. |
year | YYYY (výchozí: aktuální rok) |
upcoming | 1 = plochý seznam nadcházejících svátků podle zemí pro několik dní (nepovinné) |
days | Horizont v dnech pro režim "nadcházející", 1-180. Vynechání nebo 0 znamená bez omezení — vše, co vidí podkladová služba, tento rok a příští. |
lang | Jazyk(y) pro lokalizované pole názvu (výchozí en), stejně jako na stránce kalendáře svátků nakordoni.eu s 24 jazyky. Pro neuložená data se použije místní nebo anglický název. Seznam oddělený čárkami, max. 10 jazyků, např. lang=en,uk,pl — název se bere z prvního požadovaného jazyka; každý svátek má také objekt names s klíči podle kódů jazyků obsahující všechny překlady. |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| 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"