Календар празника — API за пословни утицај Online
Пословни утицај празника процењен моделом за малопродају, логистику и планирање тражње (Pro и виши). insights оцењује сваки празник од 0 до 100 уз вероватноћу да су продавнице затворене, категорије тражње које расту пре њега, положај у дугом викенду и мосту и наш множилац граничног саобраћаја, плус сажетак по држави. demand-surge враћа датиране прозоре око нерадних празника (пре празника, празник, после празника) са интензитетом сваког. Оцене су процене на основу типа празника, статуса нерадног дана, опсега, положаја у календару, забрана за камионе и наших множилаца саобраћаја — нису посматрани подаци о продаји.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— класа квоте: heavy
| Параметар | Опис |
|---|---|
op | insights (подразумевано) | demand-surge |
country | ISO-2 код државе или листа до 10 кодова раздвојених зарезима (обавезно) |
year | YYYY, 2020-2035 (подразумевано: текућа година) |
from | Почетак опсега YYYY-MM-DD (са to; највише 731 дан) |
to | Крај опсега YYYY-MM-DD |
region | ISO 3166-2 регион, нпр. DE-BY (опционо) |
lang | Кодови језика за називе (подразумевано: сви којима располажемо) |
min_impact | Само празници са impact_score најмање једнаким овој вредности (0-100) |
Поља одговора — унутар објекта data у коверти одговора. [] означава листу, па је data.items[].name поље name сваког елемента. Поље је null, недостаје или је празна листа када немамо вредност — никада не убацујемо замену.
| Поље | Опис |
|---|---|
data.holidays[].id | Стабилан идентификатор празника, нпр. hol_de_christmas_day_2026 — вредност коју прихвата ?id=. Дани који се обележавају (премештени) завршавају се на _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=понедељак..7=недеља), day_name, is_weekend (викенд државе). |
data.holidays[].name | en, local (на језику local_lang) и translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL или REGIONAL, regions_affected (ISO 3166-2 кодови). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (израчунат датум по исламском календару), note (suspended_martial_law, transferred_by_decree или null). |
data.holidays[].floating_logic | is_floating, rule (правило датума једноставним језиком), shifted_from (оригинални датум када је празник на викенд премештен). |
data.holidays[].truck_ban | Забрана саобраћаја камиона за време празника у тој држави: applies, time_from, time_until (локално време), min_weight_tons, eve_rule {date,time_from,time_until} за забрану уочи празника, 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 када га нема), basis model_estimated, model. |
data.summary[] | op=insights, по држави: 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), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | Идентификатор модела и напомена да су то процене. |
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"
Ažurirano