שליחת חדשות וצי NakBus נמצאים כעת בלוח השותפים
השתמשו באותם פרטי התחברות (אימייל וסיסמה) של חשבון המפתחים שלכם כדי להיכנס ללוח הבקרה של Nakordoni Partners ולנהל שם חדשות ואת צי האוטובוסים שלכם (NakDriver / NakManager) עם תפקידי צוות. מפתחות ה-API, נקודות הקצה והאפליקציות שלכם נשארים ללא שינוי, והדפים כאן ממשיכים לעבוד. פתח את Nakordoni Partners

← כל נקודות הקצה

לוח חגים — Holidays API Online

חגים ציבוריים, בנקאיים, אזוריים, דתיים וימי הנצחה ל-51 מדינות (אירופה + המפרץ) ולאזוריהן, 2020-2035, ממנוע כללי החגים שלנו. כל חג מציין אם הוא יום חופש, חג בנקאי או בתוך חופשת בית ספר, אם חג שחל בסוף שבוע הועבר ליום אחר, אם תאריכו עדיין משוער (לוח שנה אסלאמי), והאם חל איסור נסיעת משאיות באותו יום ומתי. כולל את כלל החוק הצבאי של אוקראינה (חגים מופיעים אך אינם ימי חופש) והעברות ימים בצו (transfers[]). עד 10 מדינות בקריאה; שנה או כל טווח עד 731 ימים.

GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays — מחלקת מכסה: cheap

פרמטרתיאור
countryקוד מדינה ISO-2, או רשימה מופרדת בפסיקים של עד 10 (חובה), למשל DE או DE,PL,UA
yearYYYY, 2020-2035 (ברירת מחדל: השנה הנוכחית). מתעלמים ממנו כאשר נשלח from/to
fromתחילת הטווח YYYY-MM-DD (עם to; עד 731 ימים)
toסוף הטווח YYYY-MM-DD
regionאזור ISO 3166-2, למשל DE-BY (או BY עם מדינה אחת): חגים ארציים + חגי אותו אזור בלבד. השמט עבור כל האזורים
typeמסנן מופרד בפסיקים: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE, או all. ברירת מחדל: הכול מלבד BRIDGE
langקודי שפה מופרדים בפסיקים עבור name.translations (ברירת מחדל: כל שפה שברשותנו), למשל en,uk,pl
qחיפוש בשמות החגים (בכל שפה), למשל christmas
idחג אחד לפי מזהה (שאר המסננים מתעלמים)
school1 = הצג גם תקופות חופשות בית ספר (school_holidays[]) עבור מדינות המפרסמות אותן
includeimpact = הוסף business_intelligence לכל חג (Pro ומעלה)
min_impactרק חגים עם impact_score של לפחות ערך זה (0-100); משמעותו include=impact

שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.

שדהתיאור
data.holidays[].idמזהה חג יציב, למשל hol_de_christmas_day_2026 — הערך ש-?id= מקבל. ימים נצפים (מועברים) מסתיימים ב-_obs.
data.holidays[].dateiso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=יום שני..7=יום ראשון), day_name, is_weekend (סוף השבוע במדינה).
data.holidays[].nameen, local (ב-local_lang) ו-translations {lang: name}.
data.holidays[].locationcountry_code, scope‏ NATIONAL או REGIONAL, regions_affected (קודי ISO 3166-2).
data.holidays[].classificationtype, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (תאריך מחושב בלוח השנה האסלאמי), note (suspended_martial_law, transferred_by_decree או null).
data.holidays[].floating_logicis_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עם include=impact בתוכנית Pro ומעלה: אותו בלוק המוערך על ידי מודל שמחזיר מוצר ה-impact.
data.transfers[]העברות ימים בצו בטווח: date, country_code, kind (day_off | working_day), region, note.
data.school_holidays[]עם school=1: id, start_date, end_date, name, location.
data.countהחגים שהוחזרו; countries ו-window‏ {from,to} משקפים את הבקשה.
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026&region=DE-BY&lang=en,de" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 התחבר כמפתח כדי לנסות נקודת קצה זו בשידור חי ב-sandbox — 10 קריאות בדיקה חינם לכל מוצר ליום. התחברות

עודכן