Calendario dei giorni festivi — API Impatto sul business Online
Impatto sul business delle festività stimato dal modello, per retail, logistica e pianificazione della domanda (Pro e superiori). insights assegna a ogni festività un punteggio 0-100 con la probabilità che i negozi siano chiusi, le categorie di domanda che aumentano prima della festività, la posizione rispetto a weekend lunghi e ponti e il nostro moltiplicatore del traffico di frontiera, più un riepilogo per paese. demand-surge restituisce le finestre datate intorno alle festività non lavorative (pre-festività, festività, post-festività), ciascuna con un'intensità. I punteggi sono stime basate su tipo di festività, stato di giorno non lavorativo, ambito, posizione nel calendario, divieti per i camion e i nostri moltiplicatori di traffico — non su dati di vendita osservati.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— classe di quota: heavy
| Parametro | Descrizione |
|---|---|
op | insights (predefinito) | demand-surge |
country | Codice paese ISO-2, o elenco separato da virgole fino a 10 (obbligatorio) |
year | YYYY, 2020-2035 (predefinito: anno corrente) |
from | Inizio intervallo YYYY-MM-DD (con to; al massimo 731 giorni) |
to | Fine intervallo YYYY-MM-DD |
region | Regione ISO 3166-2, ad es. DE-BY (facoltativo) |
lang | Codici lingua per i nomi (predefinito: tutte quelle disponibili) |
min_impact | Solo festività con un impact_score pari ad almeno questo valore (0-100) |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
data.holidays[].id | ID stabile della festività, ad es. hol_de_christmas_day_2026 — il valore accettato da ?id=. I giorni osservati (spostati) terminano con _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=lunedì..7=domenica), day_name, is_weekend (fine settimana del paese). |
data.holidays[].name | en, local (in local_lang) e translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL o REGIONAL, regions_affected (codici ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (data calcolata nel calendario islamico), note (suspended_martial_law, transferred_by_decree o null). |
data.holidays[].floating_logic | is_floating, rule (regola della data in linguaggio semplice), shifted_from (data originale quando una festività del fine settimana è stata spostata). |
data.holidays[].truck_ban | Divieto di circolazione dei camion nei giorni festivi in quel paese: applies, time_from, time_until (ora locale), min_weight_tons, eve_rule {date,time_from,time_until} per un divieto alla vigilia, 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 se assente), basis model_estimated, model. |
data.summary[] | op=insights, per paese: 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 (fase holiday), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | ID del modello e nota che si tratta di stime. |
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"
Aggiornato