Ünnepnaptár — Ünnepnapok API Online
Állami, banki, regionális, vallási és emléknapok 51 országra (Európa + Öböl-térség) és azok régióira, 2020-2035, saját ünnepnap-szabálymotorunkból. Minden ünnepnapnál szerepel, hogy munkaszüneti nap-e, banki ünnep-e vagy iskolai szünetre esik-e, hogy a hétvégére eső ünnepet áthelyezték-e másik napra, hogy a dátuma még becsült-e (iszlám naptár), valamint hogy aznap érvényes-e kamionforgalmi tilalom, és mikor. Lefedi Ukrajna hadiállapoti szabályát (az ünnepek szerepelnek, de nem munkaszüneti napok) és a rendeleti munkanap-áthelyezéseket (transfers[]). Hívásonként legfeljebb 10 ország; egy év vagy bármely legfeljebb 731 napos időszak.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— kvótaosztály: cheap
| Paraméter | Leírás |
|---|---|
country | ISO-2 országkód, vagy legfeljebb 10 elemű, vesszővel elválasztott lista (kötelező), pl. DE vagy DE,PL,UA |
year | YYYY, 2020-2035 (alapértelmezés: az aktuális év). Figyelmen kívül marad, ha from/to meg van adva |
from | Az időszak kezdete YYYY-MM-DD (a to-val együtt; legfeljebb 731 nap) |
to | Az időszak vége YYYY-MM-DD |
region | ISO 3166-2 régió, pl. DE-BY (vagy BY egyetlen országgal): a nemzeti ünnepek + csak az adott régió ünnepei. Hagyja el az összes régióhoz |
type | Vesszővel elválasztott szűrő: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE vagy all. Alapértelmezés: minden, a BRIDGE kivételével |
lang | Vesszővel elválasztott nyelvkódok a name.translations mezőhöz (alapértelmezés: minden rendelkezésre álló nyelv), pl. en,uk,pl |
q | Keresés az ünnepnapok nevében (bármely nyelven), pl. christmas |
id | Egy ünnepnap azonosító alapján (a többi szűrő figyelmen kívül marad) |
school | 1 = az iskolai szünetek (school_holidays[]) is szerepeljenek azoknál az országoknál, amelyek közzéteszik őket |
include | impact = business_intelligence hozzáadása minden ünnepnaphoz (Pro vagy magasabb) |
min_impact | Csak azok az ünnepnapok, amelyek impact_score értéke legalább ennyi (0-100); maga után vonja az include=impact használatát |
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.holidays[].id | Állandó ünnepnap-azonosító, pl. hol_de_christmas_day_2026 — az ?id= által fogadott érték. A megfigyelt (áthelyezett) napok azonosítója _obs végződésű. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=hétfő..7=vasárnap), day_name, is_weekend (az ország hétvégéje). |
data.holidays[].name | en, local (a local_lang nyelven) és translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL vagy REGIONAL, regions_affected (ISO 3166-2 kódok). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (számított iszlám naptári dátum), note (suspended_martial_law, transferred_by_decree vagy null). |
data.holidays[].floating_logic | is_floating, rule (a dátum szabálya közérthető nyelven), shifted_from (eredeti dátum, ha a hétvégi ünnepet áthelyezték). |
data.holidays[].truck_ban | Ünnepnapi kamionforgalmi tilalom az adott országban: applies, time_from, time_until (helyi idő), min_weight_tons, eve_rule {date,time_from,time_until} az előző napi tilalomhoz, scope_note. |
data.holidays[].business_intelligence | Pro vagy magasabb csomagnál include=impact esetén: ugyanaz a modell által becsült blokk, amelyet az impact termék ad vissza. |
data.transfers[] | Rendeleti munkanap-áthelyezések az időszakban: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | school=1 esetén: id, start_date, end_date, name, location. |
data.count | A visszaadott ünnepnapok száma; a countries és a window {from,to} a kérést tükrözi. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Frissítve