Kalendari i festave — API i ndikimit në biznes Online
Ndikimi i festave në biznes, i vlerësuar nga modeli, për shitjen me pakicë, logjistikën dhe planifikimin e kërkesës (Pro e lart). insights vlerëson çdo festë 0-100 me probabilitetin që dyqanet janë të mbyllura, kategoritë e kërkesës që rriten para saj, pozicionin e fundjavës së gjatë dhe të urës, dhe shumëzuesin tonë të trafikut kufitar, plus një përmbledhje për çdo vend. demand-surge kthen dritaret e datuara rreth festave që janë ditë pushimi (para festës, festa, pas festës), secila me një intensitet. Vlerësimet bazohen te lloji i festës, statusi i ditës së pushimit, fusha e veprimit, pozicioni në kalendar, ndalimet e kamionëve dhe shumëzuesit tanë të trafikut — nuk janë të dhëna të vëzhguara shitjesh.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— klasa e kuotës: heavy
| Parametri | Përshkrimi |
|---|---|
op | insights (parazgjedhja) | demand-surge |
country | Kodi ISO-2 i vendit, ose listë e ndarë me presje deri në 10 (e detyrueshme) |
year | YYYY, 2020-2035 (parazgjedhja: viti aktual) |
from | Fillimi i intervalit YYYY-MM-DD (me to; maksimumi 731 ditë) |
to | Fundi i intervalit YYYY-MM-DD |
region | Rajoni ISO 3166-2, p.sh. DE-BY (opsional) |
lang | Kode gjuhësh për emrat (parazgjedhja: të gjitha që disponojmë) |
min_impact | Vetëm festat me impact_score të paktën kaq (0-100) |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
data.holidays[].id | ID e qëndrueshme e festës, p.sh. hol_de_christmas_day_2026 — vlera që pranon ?id=. Ditët e vëzhguara (të zhvendosura) mbarojnë me _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=e hënë..7=e diel), day_name, is_weekend (fundjava e vendit). |
data.holidays[].name | en, local (në local_lang) dhe translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL ose REGIONAL, regions_affected (kode ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (datë e llogaritur sipas kalendarit islamik), note (suspended_martial_law, transferred_by_decree ose null). |
data.holidays[].floating_logic | is_floating, rule (rregulli i datës në gjuhë të thjeshtë), shifted_from (data origjinale kur një festë e fundjavës është zhvendosur). |
data.holidays[].truck_ban | Ndalimi i qarkullimit të kamionëve në festë në atë vend: applies, time_from, time_until (ora lokale), min_weight_tons, eve_rule {date,time_from,time_until} për ndalim në prag të festës, 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 kur nuk ka), basis model_estimated, model. |
data.summary[] | op=insights, për çdo vend: 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 e modelit dhe shënimi se këto janë vlerësime. |
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"
Përditësuar