Calendrier des jours fériés — API Impact commercial Online
Impact commercial des jours fériés estimé par modèle, pour le commerce de détail, la logistique et la planification de la demande (Pro et supérieur). insights note chaque jour férié de 0 à 100 avec la probabilité de fermeture des magasins, les catégories de demande en hausse avant celui-ci, la position en week-end prolongé et en pont, et notre multiplicateur de trafic frontalier, plus un récapitulatif par pays. demand-surge renvoie les fenêtres datées autour des jours fériés chômés (pré-férié, férié, post-férié) avec une intensité pour chacune. Les scores sont des estimations fondées sur le type de jour férié, le statut de jour chômé, la portée, la position dans le calendrier, les interdictions de circulation des camions et nos multiplicateurs de trafic — et non sur des données de ventes observées.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— classe de quota: heavy
| Paramètre | Description |
|---|---|
op | insights (par défaut) | demand-surge |
country | Code pays ISO-2, ou liste séparée par des virgules de 10 au maximum (obligatoire) |
year | YYYY, 2020-2035 (par défaut : année en cours) |
from | Début de la plage YYYY-MM-DD (avec to ; 731 jours maximum) |
to | Fin de la plage YYYY-MM-DD |
region | Région ISO 3166-2, p. ex. DE-BY (facultatif) |
lang | Codes de langue pour les noms (par défaut : toutes les langues disponibles) |
min_impact | Uniquement les jours fériés dont l'impact_score est au moins égal à cette valeur (0-100) |
Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.
| Champ | Description |
|---|---|
data.holidays[].id | Identifiant stable du jour férié, p. ex. hol_de_christmas_day_2026 — la valeur acceptée par ?id=. Les jours observés (reportés) se terminent par _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=lundi..7=dimanche), day_name, is_weekend (week-end du pays). |
data.holidays[].name | en, local (dans local_lang) et translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL ou REGIONAL, regions_affected (codes ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (date calculée selon le calendrier islamique), note (suspended_martial_law, transferred_by_decree ou null). |
data.holidays[].floating_logic | is_floating, rule (règle de date en langage clair), shifted_from (date d'origine lorsqu'un jour férié tombant un week-end a été reporté). |
data.holidays[].truck_ban | Interdiction de circulation des camions les jours fériés dans ce pays : applies, time_from, time_until (heure locale), min_weight_tons, eve_rule {date,time_from,time_until} pour une interdiction la veille, 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 si aucun), basis model_estimated, model. |
data.summary[] | op=insights, par pays : 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 (phase holiday), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | Identifiant du modèle et mention qu'il s'agit d'estimations. |
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"
Mis à jour