Kalendár sviatkov — API obchodného dopadu Online
Modelom odhadnutý obchodný dopad sviatkov pre maloobchod, logistiku a plánovanie dopytu (Pro a vyššie). insights ohodnotí každý sviatok skóre 0-100 spolu s pravdepodobnosťou, že obchody budú zatvorené, kategóriami dopytu, ktoré pred ním rastú, pozíciou dlhého víkendu a mostu a naším násobiteľom hraničnej premávky, plus súhrn za krajinu. demand-surge vracia datované okná okolo sviatkov, ktoré sú voľnými dňami (pred sviatkom, sviatok, po sviatku), každé s intenzitou. Skóre sú odhady na základe typu sviatku, stavu voľného dňa, rozsahu, polohy v kalendári, zákazov jazdy nákladných vozidiel a našich násobiteľov premávky — nie sú to pozorované údaje o predaji.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— trieda kvóty: heavy
| Parameter | Popis |
|---|---|
op | insights (predvolené) | demand-surge |
country | Dvojznakový kód krajiny ISO alebo zoznam až 10 kódov oddelených čiarkou (povinné) |
year | YYYY, 2020-2035 (predvolené: aktuálny rok) |
from | Začiatok rozsahu YYYY-MM-DD (s to; najviac 731 dní) |
to | Koniec rozsahu YYYY-MM-DD |
region | Región ISO 3166-2, napr. DE-BY (voliteľné) |
lang | Kódy jazykov pre názvy (predvolené: všetky evidované) |
min_impact | Iba sviatky s impact_score najmenej touto hodnotou (0-100) |
Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.
| Pole | Popis |
|---|---|
data.holidays[].id | Stabilné ID sviatku, napr. hol_de_christmas_day_2026 — hodnota, ktorú prijíma ?id=. Náhradné (presunuté) dni končia na _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=pondelok..7=nedeľa), day_name, is_weekend (víkend danej krajiny). |
data.holidays[].name | en, local (v local_lang) a translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL alebo REGIONAL, regions_affected (kódy ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (vypočítaný dátum podľa islamského kalendára), note (suspended_martial_law, transferred_by_decree alebo null). |
data.holidays[].floating_logic | is_floating, rule (pravidlo dátumu v bežnom jazyku), shifted_from (pôvodný dátum, keď sa sviatok vo víkende presunul). |
data.holidays[].truck_ban | Sviatočný zákaz jazdy nákladných vozidiel v danej krajine: applies, time_from, time_until (miestny čas), min_weight_tons, eve_rule {date,time_from,time_until} pre zákaz v predvečer sviatku, 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, ak neexistuje), basis model_estimated, model. |
data.summary[] | op=insights, za krajinu: 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 (fáza holiday), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | ID modelu a poznámka, že ide o odhady. |
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"
Aktualizované