Календар свят — 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"
Оновлено