Tatil Takvimi — İş Etkisi API'si Online
Perakende, lojistik ve talep planlaması için tatillerin model tahminli iş etkisi (Pro ve üzeri). insights her tatili 0-100 arasında puanlar: mağazaların kapalı olma olasılığı, tatilden önce artan talep kategorileri, uzun hafta sonu ve köprü konumu ile sınır trafiği çarpanımız; ayrıca ülke bazında bir özet sunar. demand-surge, izin günü tatillerinin çevresindeki tarihli pencereleri (pre-holiday, holiday, post-holiday) her biri bir yoğunlukla döndürür. Puanlar; tatil türü, izin günü durumu, kapsam, takvimdeki konum, kamyon yasakları ve trafik çarpanlarımızdan elde edilen tahminlerdir — gözlemlenen satış verisi değildir.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— kota sınıfı: heavy
| Parametre | Açıklama |
|---|---|
op | insights (varsayılan) | demand-surge |
country | ISO-2 ülke kodu veya en fazla 10 kodluk virgülle ayrılmış liste (zorunlu) |
year | YYYY, 2020-2035 (varsayılan: geçerli yıl) |
from | Aralık başlangıcı YYYY-MM-DD (to ile birlikte; en fazla 731 gün) |
to | Aralık sonu YYYY-MM-DD |
region | ISO 3166-2 bölgesi, örn. DE-BY (isteğe bağlı) |
lang | Adlar için dil kodları (varsayılan: sahip olunan tümü) |
min_impact | Yalnızca impact_score değeri bu değerden büyük veya eşit olan tatiller (0-100) |
Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.
| Alan | Açıklama |
|---|---|
data.holidays[].id | Kalıcı tatil kimliği, örn. hol_de_christmas_day_2026 — ?id= parametresinin aldığı değer. Gözlemlenen (kaydırılan) günler _obs ile biter. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Pazartesi..7=Pazar), day_name, is_weekend (ülkenin hafta sonu). |
data.holidays[].name | en, local (local_lang dilinde) ve translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL veya REGIONAL, regions_affected (ISO 3166-2 kodları). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (hesaplanmış İslami takvim tarihi), note (suspended_martial_law, transferred_by_decree veya null). |
data.holidays[].floating_logic | is_floating, rule (sade dille tarih kuralı), shifted_from (hafta sonu tatili kaydırıldığında özgün tarih). |
data.holidays[].truck_ban | İlgili ülkedeki tatil kamyon sürüş yasağı: applies, time_from, time_until (yerel saat), min_weight_tons, arife günü yasağı için 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 (yoksa null), basis model_estimated, model. |
data.summary[] | op=insights, ülke bazında: 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 evresi), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | Model kimliği ve bunların tahmin olduğuna dair not. |
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"
Güncellendi