API Ünnepi Naptár Online
Európai országok hivatalos nyilvános ünnepei — dátumok, helyi nevek és típus, az egyes országok teljes ünnepnaptára benne foglalva. A Nager.Date / OpenHolidaysAPI szolgáltatás (7 napos cache, helyileg számított koszovói naptár) által támogatva, amely a nakordoni.eu ünnepnaptár oldalt és az előrejelzési rendszer naptári tényezőit működteti. Egy ország egy lapos objektumot ad vissza; több ország ugyanezt az alakzatot egy listába csomagolva adja vissza. upcoming=1 egy lapos, dátum szerint rendezett, nemzetközi adatfolyamra vált; compare_to egy azonos/különbözőség összehasonlításra vált az országok között, hasznos annak ellenőrzéséhez, hogy egy dátum ünnep-e a határátkelőhely mindkét oldalán vagy csak az egyiken.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— kvótaosztály: cheap
| Paraméter | Leírás |
|---|---|
country | ISO-2 országkód, vagy legfeljebb 15 kódból vesszővel elválasztott lista, pl. PL vagy PL,DE,UA. Hagyja üresen az alapértelmezett halmaz (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT) esetén. Egy kód egy egyszerű objektumot ad vissza; több kód egy listát. |
compare_to | ISO-2 országkód, vagy vesszővel elválasztott lista összehasonlításhoz. Átvált összehasonlító módba: visszaadja, mely ünnepnapok közösek AZONOSAN az összes kiválasztott országban (azonosak) és melyek csak néhányban (különbözőek, minden dátumra külön be/nincs listákkal). Az upcoming és days paraméterekkel együtt működik — szűkíti az azonos/eltérő napokat a teljes év helyett a kiválasztott dátumablakra. |
year | YYYY (alapértelmezett: aktuális év) |
upcoming | 1 = lapos lista az elkövetkezendő országonkénti ünnepekről néhány napra (opcionális) |
days | Napok horizontja a „következő” módhoz, 1-180. A kihagyás vagy 0 azt jelenti, hogy nincs korlátozás — minden, amit az alapszolgáltatás lát, ebben az évben és a következőben. |
lang | A lokalizált név mező nyelve(i) (alapértelmezett: en), a nakordoni.eu ünnepnap-kalendárium oldala szerint 24 nyelvvel. Nem cache-elődött adatoknál a helyi vagy angol név kerül felhasználásra. Vesszővel elválasztva, max. 10 nyelv, pl. lang=en,uk,pl — a név az első kért nyelvből származik; minden ünnep rendelkezik egy names objektummal, amely nyelvkódokkal van indexelve, és tartalmazza az összes fordítást. |
Válaszmezők — a válaszboríték data objektumán belül. A [] listát jelöl, tehát a data.items[].name az egyes elemek name mezője. Egy mező null, hiányzik vagy üres lista, ha nincs rá értékünk — helykitöltőt soha nem teszünk oda.
| Mező | Leírás |
|---|---|
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"