Календарь праздников — 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=. Перенесённые (observed) дни оканчиваются на _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"
Обновлено