API Ημερολόγιο Διακοπών Online
Επίσημες δημόσιες αργίες ανά ευρωπαϊκή χώρα — ημερομηνίες, τοπικά ονόματα και τύπος, με τη πλήρη λίστα αργιών κάθε χώρας. Υποστηρίζεται από την ίδια υπηρεσία Nager.Date / OpenHolidaysAPI (cache 7 ημερών, τοπικά υπολογισμένο ημερολόγιο Κοσόβου) που τροφοδοτεί τη σελίδα ημερολογίου αργιών nakordoni.eu και τους συντελεστές ημερολογίου του συστήματος πρόβλεψης. Μία χώρα επιστρέφει ένα flat object· πολλές επιστρέφουν το ίδιο σχήμα τυλιγμένο σε λίστα. Το upcoming=1 αλλάζει σε ένα flat, date-sorted cross-country feed· το compare_to αλλάζει σε μια σύγκριση same-vs-different σε όλες τις χώρες, χρήσιμη για τον έλεγχο κατά πόσον μια ημερομηνία είναι αργία και στις δύο πλευρές μιας διέλευσης συνόρων ή μόνο στη μία.
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"