Ünnepnaptár — Üzleti hatás API Online
Az ünnepnapok modell által becsült üzleti hatása kiskereskedelmi, logisztikai és kereslettervezési célokra (Pro vagy magasabb). Az insights minden ünnepnapot 0-100 között pontoz: annak valószínűségével, hogy a boltok zárva lesznek, az előtte növekvő keresleti kategóriákkal, a hosszú hétvégén és áthidaló napként elfoglalt helyzettel és a határforgalmi szorzónkkal, továbbá országonkénti összesítéssel. A demand-surge a munkaszüneti ünnepek körüli datált időablakokat adja vissza (pre-holiday, holiday, post-holiday), mindegyiket intenzitással. A pontszámok becslések az ünnep típusa, a munkaszüneti státusz, a hatókör, a naptári pozíció, a kamiontilalmak és a forgalmi szorzóink alapján — nem megfigyelt értékesítési adatok.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— kvótaosztály: heavy
| Paraméter | Leírás |
|---|---|
op | insights (alapértelmezés) | demand-surge |
country | ISO-2 országkód, vagy legfeljebb 10 elemű, vesszővel elválasztott lista (kötelező) |
year | YYYY, 2020-2035 (alapértelmezés: az aktuális év) |
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 (opcionális) |
lang | Nyelvkódok a nevekhez (alapértelmezés: az összes rendelkezésre álló) |
min_impact | Csak azok az ünnepnapok, amelyek impact_score értéke legalább ennyi (0-100) |
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 | impact_score 0-100, retail_closure_probability 0-1, demand_surge_categories[], long_weekend, bridge_opportunity, holiday_family, border_traffic_multiplier (null, ha nincs), basis model_estimated, model. |
data.summary[] | op=insights, országonként: holidays, weekday_days_off, long_weekends, average_impact_score, top_holidays[3]. |
data.windows[] | op=demand-surge: date, phase (pre_holiday | holiday | post_holiday), intensity 0-100, demand_surge_categories, retail_closure_probability (holiday fázis), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | A modell azonosítója és a megjegyzés, hogy ezek becslések. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/impact?op=insights&country=DE,PL&year=2026" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Frissítve