Kalendarz świąt — API wpływu na biznes Online
Szacowany przez model wpływ świąt na biznes na potrzeby handlu detalicznego, logistyki i planowania popytu (Pro i wyższy). insights ocenia każde święto w skali 0-100 i podaje prawdopodobieństwo zamknięcia sklepów, kategorie popytu rosnące przed świętem, położenie względem długiego weekendu i mostka oraz nasz mnożnik ruchu granicznego, a także podsumowanie dla każdego kraju. demand-surge zwraca datowane okna wokół świąt będących dniami wolnymi (przed świętem, święto, po święcie), każde z natężeniem. Oceny są szacunkami opartymi na typie święta, statusie dnia wolnego, zasięgu, położeniu w kalendarzu, zakazach ruchu ciężarówek i naszych mnożnikach ruchu — nie są to rzeczywiste dane o sprzedaży.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— klasa limitu: heavy
| Parametr | Opis |
|---|---|
op | insights (domyślnie) | demand-surge |
country | Kod kraju ISO-2 lub lista rozdzielona przecinkami do 10 kodów (wymagane) |
year | YYYY, 2020-2035 (domyślnie: bieżący rok) |
from | Początek zakresu YYYY-MM-DD (razem z to; maksymalnie 731 dni) |
to | Koniec zakresu YYYY-MM-DD |
region | Region ISO 3166-2, np. DE-BY (opcjonalne) |
lang | Kody języków dla nazw (domyślnie: wszystkie posiadane) |
min_impact | Tylko święta z impact_score co najmniej równym tej wartości (0-100) |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
data.holidays[].id | Stabilny identyfikator święta, np. hol_de_christmas_day_2026 — wartość przyjmowana przez ?id=. Dni przeniesione (observed) kończą się na _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=poniedziałek..7=niedziela), day_name, is_weekend (weekend w danym kraju). |
data.holidays[].name | en, local (w języku local_lang) oraz translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL lub REGIONAL, regions_affected (kody ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (obliczona data według kalendarza islamskiego), note (suspended_martial_law, transferred_by_decree lub null). |
data.holidays[].floating_logic | is_floating, rule (reguła wyznaczania daty w języku potocznym), shifted_from (pierwotna data, gdy święto weekendowe zostało przeniesione). |
data.holidays[].truck_ban | Świąteczny zakaz ruchu ciężarówek w danym kraju: applies, time_from, time_until (czas lokalny), min_weight_tons, eve_rule {date,time_from,time_until} dla zakazu w przeddzień, 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, gdy brak), basis model_estimated, model. |
data.summary[] | op=insights, dla każdego kraju: 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 (faza holiday), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | Identyfikator modelu oraz uwaga, że są to szacunki. |
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"
Zaktualizowano