לוח חגים — Business Impact API Online
ההשפעה העסקית של חגים כפי שהוערכה על ידי מודל, עבור קמעונאות, לוגיסטיקה ותכנון ביקוש (Pro ומעלה). insights מדרג כל חג בין 0 ל-100 עם ההסתברות שחנויות סגורות, קטגוריות הביקוש שעולות לפניו, מיקום בסוף שבוע ארוך ובגשר ומכפיל תנועת הגבולות שלנו, וכן סיכום לכל מדינה. demand-surge מחזיר את החלונות המתוארכים סביב חגי יום חופש (pre-holiday, holiday, post-holiday), לכל אחד עם עוצמה. הציונים הם הערכות המבוססות על סוג החג, מצב יום חופש, היקף, מיקום בלוח השנה, איסורי משאיות ומכפילי התנועה שלנו — לא נתוני מכירות שנצפו.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— מחלקת מכסה: heavy
| פרמטר | תיאור |
|---|---|
op | insights (ברירת מחדל) | demand-surge |
country | קוד מדינה ISO-2, או רשימה מופרדת בפסיקים של עד 10 (חובה) |
year | YYYY, 2020-2035 (ברירת מחדל: השנה הנוכחית) |
from | תחילת הטווח YYYY-MM-DD (עם to; עד 731 ימים) |
to | סוף הטווח YYYY-MM-DD |
region | אזור ISO 3166-2, למשל DE-BY (אופציונלי) |
lang | קודי שפה לשמות (ברירת מחדל: כל השפות שברשותנו) |
min_impact | רק חגים עם impact_score של לפחות ערך זה (0-100) |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.holidays[].id | מזהה חג יציב, למשל hol_de_christmas_day_2026 — הערך ש-?id= מקבל. ימים נצפים (מועברים) מסתיימים ב-_obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=יום שני..7=יום ראשון), day_name, is_weekend (סוף השבוע במדינה). |
data.holidays[].name | en, local (ב-local_lang) ו-translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL או REGIONAL, regions_affected (קודי ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (תאריך מחושב בלוח השנה האסלאמי), note (suspended_martial_law, transferred_by_decree או null). |
data.holidays[].floating_logic | is_floating, rule (כלל התאריך בלשון פשוטה), shifted_from (התאריך המקורי כאשר חג של סוף שבוע הועבר). |
data.holidays[].truck_ban | איסור נסיעת משאיות בחג באותה מדינה: applies, time_from, time_until (שעון מקומי), min_weight_tons, 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 (null כשאין), basis model_estimated, model. |
data.summary[] | op=insights, לכל מדינה: 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), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | מזהה המודל וההערה שאלו הערכות. |
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"
עודכן