לוח חגים API Online
Official public holidays per European country — dates, local names and type, each country's full holiday list included. Backed by the same Nager.Date / OpenHolidaysAPI service (7-day cache, locally-computed Kosovo calendar) that powers the nakordoni.eu holiday calendar page and the prediction system's calendar factors. One country returns a flat object; several return the same shape wrapped in a list. upcoming=1 switches to a flat, date-sorted cross-country feed; compare_to switches to a same-vs-different comparison across countries, useful for checking whether a date is a holiday on both sides of a border crossing or just one.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— מחלקת מכסה: cheap
| פרמטר | תיאור |
|---|---|
country | קוד מדינה ISO-2, או רשימה של עד 15 קודים מופרדים בפסיקים, למשל PL או PL,DE,UA. השאר ריק עבור הסט המוגדר כברירת מחדל (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). קוד יחיד מחזיר אובייקט שטוח; מספר קודים מחזירים רשימה. |
compare_to | קוד ISO-2 של מדינה, או רשימה מופרדת בפסיקים, להשוואה. עובר למצב השוואה: מחזיר אילו תאריכי חגים משותפים לכל המדינות שנבחרו (זהים) ואילו רק לחלק מהן (שונים, עם רשימות נפרדות של בתוך/מחוץ לכל תאריך). הפרמטרים upcoming ו-days עובדים יחד עם זה — מצמצמים את הזהים/שונים לחלון התאריכים הנבחר במקום לשנה מלאה. |
year | YYYY (ברירת מחדל: שנה נוכחית) |
upcoming | 1 = רשימה שטוחה של חגים עתידיים לפי מדינות לימים ספורים (אופציונלי) |
days | אופק בימים עבור מצב "עתידי", 1-180. השמטה או 0 פירושם ללא הגבלה — כל מה שהשירות הבסיסי יכול לראות, השנה הבאה ושנה זו. |
lang | שפת(י) השדה לשם מקומי (ברירת מחדל: en), בדומה לעמוד לוח החגים של nakordoni.eu ב-24 שפות. עבור נתונים שלא נטענו מטמון משתמשים בשם המקומי או האנגלי. רשימה מופרדת בפסיקים, עד 10 שפות, למשל lang=en,uk,pl — השם נלקח מהשפה הראשונה המבוקשת; כל חגיגה כוללת גם אובייקט names עם מפתחות לפי קודי שפות המכיל את כל התרגומים. |
curl "https://nakordoni.eu/api/v1/data/holiday-calendar?country=PL&compare_to=UA&year=2026&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Log in as a developer to try this endpoint live in the sandbox — 50 free test calls a day. התחברות