לוח חגים API Online
חגים רשמיים לפי מדינות אירופיות — תאריכים, שמות מקומיים וסוג, רשימת החגים המלאה של כל מדינה כלולה. מופעל על ידי שירות Nager.Date / OpenHolidaysAPI (מטמון של 7 ימים, לוח שנה של קוסובו המחושב באופן מקומי) זהה לזה המפעיל את דף לוח השנה של חגים של nakordoni.eu וגורמי לוח השנה של מערכת החיזוי. מדינה אחת מחזירה אובייקט שטוח; מספר מדינות מחזירות את אותה צורה עטופה ברשימה. upcoming=1 משנה להזנה שטוחה ממוינת לפי תאריך על פני מדינות; compare_to משנה להשוואה זהה-לעומת-שונה על פני מדינות, שימושית לבדיקת האם תאריך הוא חג משני צידי מעבר גבול או רק מאחד.
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 עם מפתחות לפי קודי שפות המכיל את כל התרגומים. |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.countries | The countries compared — the one you asked about and compare_to. |
data.same[] | Days that are a public holiday in BOTH countries: date, weekday, names (one per country). |
data.different[] | Days that are a holiday in one country only: date, weekday, in (where it applies), not_in, names. These are the border-traffic days that catch drivers out. |
data.same_count | Size of same, with different_count for different. |
data.window | Period covered, inside data.year. |
data.mode | Single-country listing or two-country comparison. |
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"