API Kalendarz świąt Online
Oficjalne dni wolne od pracy dla każdego kraju europejskiego — daty, nazwy lokalne i typ, z pełną listą dni wolnych dla każdego kraju. Wspierane przez tę samą usługę Nager.Date / OpenHolidaysAPI (cache 7-dniowy, lokalnie obliczany kalendarz Kosovo), która napędza stronę kalendarza dni wolnych nakordoni.eu oraz czynniki kalendarzowe systemu predykcji. Jeden kraj zwraca flat object; kilka krajów zwraca tę samą strukturę zawiniętą w listę. upcoming=1 przełącza na flat, date-sorted cross-country feed; compare_to przełącza na porównanie same-vs-different między krajami, przydatne do sprawdzenia, czy dana data jest dniem wolnym po obu stronach przejścia granicznego czy tylko po jednej.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
country | Kod kraju ISO-2, lub lista do 15 kodów oddzielonych przecinkami, np. PL lub PL,DE,UA. Pominięcie dla domyślnego zestawu (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Jeden kod zwraca płaski obiekt; kilka kodów — listę. |
compare_to | Kod ISO-2 kraju lub lista oddzielona przecinkami do porównania. Przełącza tryb porównywania: zwraca, które daty świąteczne są wspólne DLA WSZYSTKICH wybranych krajów (takie same) oraz które tylko dla niektórych (różne, z osobnymi listami w/nie_w dla każdej daty). Parametry upcoming i days działają z tym — zawężają te same/różne do wybranego okna dat zamiast całego roku. |
year | YYYY (domyślnie: bieżący rok) |
upcoming | 1 = płaska lista nadchodzących świąt w poszczególnych krajach w ciągu kilku dni (opcjonalnie) |
days | Horyzont w dniach dla trybu "nadchodzący", 1-180. Pominięcie lub 0 oznacza brak limitu — wszystko, co widzi podstawowa usługa, w tym roku i następnym. |
lang | Język(i) dla lokalizowanej nazwy pola (domyślnie en), identycznie jak na stronie kalendarza świąt nakordoni.eu z 24 językami. Dla niezasobowanych danych używana jest nazwa lokalna lub angielska. Lista oddzielona przecinkami, maksymalnie 10 języków, np. lang=en,uk,pl — nazwa pobierana z pierwszego żądanego języka; każde święto posiada również obiekt names kluczowany kodami języków zawierający wszystkie tłumaczenia. |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
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"