Calendar de sărbători — API Impact asupra afacerilor Online
Impactul estimat de model al sărbătorilor asupra afacerilor, pentru retail, logistică și planificarea cererii (Pro sau superior). insights acordă fiecărei sărbători un scor 0-100, cu probabilitatea ca magazinele să fie închise, categoriile de cerere care cresc înainte de ea, poziția de weekend lung și de punte și multiplicatorul nostru de trafic la frontieră, plus un rezumat pe țară. demand-surge returnează ferestrele datate din jurul sărbătorilor libere (pre-holiday, holiday, post-holiday), fiecare cu o intensitate. Scorurile sunt estimări bazate pe tipul sărbătorii, statutul de zi liberă, domeniul de aplicare, poziția în calendar, interdicțiile pentru camioane și multiplicatorii noștri de trafic — nu date observate de vânzări.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— clasă de cotă: heavy
| Parametru | Descriere |
|---|---|
op | insights (implicit) | demand-surge |
country | Cod de țară ISO-2 sau listă separată prin virgulă de până la 10 (obligatoriu) |
year | YYYY, 2020-2035 (implicit: anul curent) |
from | Începutul intervalului YYYY-MM-DD (împreună cu to; cel mult 731 de zile) |
to | Sfârșitul intervalului YYYY-MM-DD |
region | Regiune ISO 3166-2, de ex. DE-BY (opțional) |
lang | Coduri de limbă pentru denumiri (implicit: toate cele disponibile) |
min_impact | Doar sărbători cu un impact_score de cel puțin această valoare (0-100) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.holidays[].id | ID stabil al sărbătorii, de ex. hol_de_christmas_day_2026 — valoarea acceptată de ?id=. Zilele observate (mutate) se termină cu _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=luni..7=duminică), day_name, is_weekend (weekendul țării). |
data.holidays[].name | en, local (în local_lang) și translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL sau REGIONAL, regions_affected (coduri ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (dată calculată după calendarul islamic), note (suspended_martial_law, transferred_by_decree sau null). |
data.holidays[].floating_logic | is_floating, rule (regula datei în limbaj simplu), shifted_from (data originală când o sărbătoare din weekend a fost mutată). |
data.holidays[].truck_ban | Interdicție de circulație pentru camioane în sărbători în țara respectivă: applies, time_from, time_until (ora locală), min_weight_tons, eve_rule {date,time_from,time_until} pentru o interdicție în ajun, 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 când nu există), basis model_estimated, model. |
data.summary[] | op=insights, pe țară: 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 | ID-ul modelului și mențiunea că acestea sunt estimări. |
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"
Actualizat