Bayram təqvimi — Business Impact API Online
Pərakəndə satış, logistika və tələbin planlaşdırılması üçün bayramların biznesə model əsaslı təxmini təsiri (Pro və yuxarı). insights hər bayramı 0-100 şkalası ilə qiymətləndirir: mağazaların bağlı olma ehtimalı, ondan əvvəl artan tələb kateqoriyaları, uzun həftə sonu və körpü mövqeyi və sərhəd trafiki vuruğumuz, üstəlik ölkə üzrə xülasə. demand-surge istirahət günü olan bayramların ətrafında tarixli pəncərələri (pre-holiday, holiday, post-holiday) hər birinin intensivliyi ilə qaytarır. Qiymətlər bayram növü, istirahət günü statusu, əhatə dairəsi, təqvimdəki mövqe, yük maşını qadağaları və trafik vuruqlarımız əsasında təxminlərdir — müşahidə olunmuş satış məlumatları deyil.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— kvota sinfi: heavy
| Parametr | Təsvir |
|---|---|
op | insights (susmaya görə) | demand-surge |
country | ISO-2 ölkə kodu və ya 10-a qədər kodun vergüllə ayrılmış siyahısı (məcburi) |
year | YYYY, 2020-2035 (susmaya görə: cari il) |
from | Aralığın başlanğıcı YYYY-MM-DD (to ilə; ən çox 731 gün) |
to | Aralığın sonu YYYY-MM-DD |
region | ISO 3166-2 region, məs. DE-BY (könüllü) |
lang | Adlar üçün dil kodları (susmaya görə: əlimizdə olanların hamısı) |
min_impact | Yalnız impact_score-u ən azı bu qədər olan bayramlar (0-100) |
Cavab sahələri — cavab zərfindəki data obyektinin içində. [] siyahını bildirir, yəni data.items[].name hər elementin name sahəsidir. Dəyəri olmayan sahə null olur, ümumiyyətlə görünmür və ya boş siyahı qaytarır — heç vaxt doldurucu qoymuruq.
| Sahə | Təsvir |
|---|---|
data.holidays[].id | Sabit bayram id-si, məs. hol_de_christmas_day_2026 — ?id= parametrinin qəbul etdiyi dəyər. Müşahidə olunan (köçürülmüş) günlər _obs ilə bitir. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Bazar ertəsi..7=Bazar), day_name, is_weekend (ölkənin həftə sonu). |
data.holidays[].name | en, local (local_lang dilində) və translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL və ya REGIONAL, regions_affected (ISO 3166-2 kodları). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (hesablanmış İslam təqvimi tarixi), note (suspended_martial_law, transferred_by_decree və ya null). |
data.holidays[].floating_logic | is_floating, rule (tarix qaydası sadə dildə), shifted_from (həftə sonu bayramı köçürüldükdə ilkin tarix). |
data.holidays[].truck_ban | Həmin ölkədə bayram günü yük maşınlarının hərəkətinə qadağa: applies, time_from, time_until (yerli vaxtla), min_weight_tons, ərəfə günü qadağa üçün eve_rule {date,time_from,time_until}, 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 (yoxdursa null), basis model_estimated, model. |
data.summary[] | op=insights, ölkə üzrə: 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 (holiday fazası), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | Model id-si və bunların təxmin olduğunu bildirən qeyd. |
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"
Yeniləndi