Bayramlar kalendari — Biznesga ta'sir API Online
Chakana savdo, logistika va talabni rejalashtirish uchun bayramlarning biznesga model bo'yicha baholangan ta'siri (Pro va undan yuqori). insights har bir bayramni 0-100 ball bilan baholaydi: do'konlar yopiq bo'lish ehtimoli, bayram oldidan oshadigan talab toifalari, uzun dam olish kunlari va ko'prik kunlaridagi o'rni hamda chegara transporti koeffitsiyenti, shuningdek har bir davlat bo'yicha xulosa. demand-surge dam olish bayramlari atrofidagi sanalangan oraliqlarni (bayram oldi, bayram, bayramdan keyin) har biri intensivligi bilan qaytaradi. Ballar bayram turi, dam olish kuni maqomi, qamrov, kalendardagi o'rni, yuk mashinalari taqiqlari va transport koeffitsiyentlarimiz asosidagi baholar — kuzatilgan savdo ma'lumotlari emas.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— kvota sinfi: heavy
| Parametr | Tavsif |
|---|---|
op | insights (standart) | demand-surge |
country | ISO-2 davlat kodi yoki 10 tagacha vergul bilan ajratilgan ro'yxat (majburiy) |
year | YYYY, 2020-2035 (standart: joriy yil) |
from | Oraliq boshi YYYY-MM-DD (to bilan; ko'pi bilan 731 kun) |
to | Oraliq oxiri YYYY-MM-DD |
region | ISO 3166-2 hudud, masalan DE-BY (ixtiyoriy) |
lang | Nomlar uchun til kodlari (standart: mavjud barcha tillar) |
min_impact | Faqat impact_score qiymati kamida shuncha bo'lgan bayramlar (0-100) |
Javob maydonlari — javob konvertidagi data obyekti ichida. [] ro‘yxatni bildiradi, ya’ni data.items[].name har bir elementning name maydonidir. Qiymatimiz bo‘lmagan maydon null bo‘ladi, umuman bo‘lmaydi yoki bo‘sh ro‘yxat qaytadi — o‘rniga hech qachon soxta qiymat qo‘ymaymiz.
| Maydon | Tavsif |
|---|---|
data.holidays[].id | Barqaror bayram identifikatori, masalan hol_de_christmas_day_2026 — ?id= qabul qiladigan qiymat. Ko'chirilgan (kuzatiladigan) kunlar _obs bilan tugaydi. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=dushanba..7=yakshanba), day_name, is_weekend (davlatning dam olish kunlari). |
data.holidays[].name | en, local (local_lang tilida) va translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL yoki REGIONAL, regions_affected (ISO 3166-2 kodlari). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (hijriy kalendar bo'yicha hisoblangan sana), note (suspended_martial_law, transferred_by_decree yoki null). |
data.holidays[].floating_logic | is_floating, rule (sana qoidasi oddiy tilda), shifted_from (dam olish kuniga to'g'ri kelgan bayram ko'chirilganda asl sana). |
data.holidays[].truck_ban | Bayram kunida o'sha davlatda yuk mashinalari harakatiga taqiq: applies, time_from, time_until (mahalliy vaqt), min_weight_tons, bayram arafasidagi taqiq uchun 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 (yo'q bo'lsa null), basis model_estimated, model. |
data.summary[] | op=insights, har bir davlat bo'yicha: 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 fazasi), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | Model identifikatori va bular baholar ekani haqidagi izoh. |
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"
Yangilandi