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. Σύνδεση