Kalendář svátků — API obchodního dopadu Online
Modelem odhadnutý obchodní dopad svátků pro maloobchod, logistiku a plánování poptávky (Pro a vyšší). insights ohodnotí každý svátek skóre 0-100 spolu s pravděpodobností, že obchody budou zavřené, kategoriemi poptávky, které před ním rostou, pozicí dlouhého víkendu a mostu a naším násobitelem hraničního provozu, plus souhrn za zemi. demand-surge vrací datovaná okna kolem svátků, které jsou dny volna (před svátkem, svátek, po svátku), každé s intenzitou. Skóre jsou odhady na základě typu svátku, stavu dne volna, rozsahu, polohy v kalendáři, zákazů jízdy nákladních vozidel a našich násobitelů provozu — nejde o pozorovaná data o prodeji.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— třída kvóty: heavy
| Parametr | Popis |
|---|---|
op | insights (výchozí) | demand-surge |
country | Dvouznakový kód země ISO nebo seznam až 10 kódů oddělených čárkou (povinné) |
year | YYYY, 2020-2035 (výchozí: aktuální rok) |
from | Začátek rozsahu YYYY-MM-DD (s to; nejvýše 731 dnů) |
to | Konec rozsahu YYYY-MM-DD |
region | Region ISO 3166-2, např. DE-BY (volitelné) |
lang | Kódy jazyků pro názvy (výchozí: všechny evidované) |
min_impact | Pouze svátky s impact_score alespoň této hodnoty (0-100) |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| Pole | Popis |
|---|---|
data.holidays[].id | Stabilní ID svátku, např. hol_de_christmas_day_2026 — hodnota, kterou přijímá ?id=. Náhradní (přesunuté) dny končí na _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=pondělí..7=neděle), day_name, is_weekend (víkend dané země). |
data.holidays[].name | en, local (v local_lang) a translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL nebo 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čtené datum podle islámského kalendáře), note (suspended_martial_law, transferred_by_decree nebo null). |
data.holidays[].floating_logic | is_floating, rule (pravidlo data v běžném jazyce), shifted_from (původní datum, když se svátek o víkendu přesunul). |
data.holidays[].truck_ban | Svátkový zákaz jízdy nákladních vozidel v dané zemi: applies, time_from, time_until (místní čas), min_weight_tons, eve_rule {date,time_from,time_until} pro zákaz v předvečer svátku, 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, pokud neexistuje), basis model_estimated, model. |
data.summary[] | op=insights, za zemi: 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áze holiday), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | ID modelu a poznámka, že jde 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"
Aktualizováno