Календар на празници — 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"
Ажурирано