Ημερολόγιο αργιών — 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 |
year | YYYY, 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 | Μία αργία με βάση το id (τα άλλα φίλτρα αγνοούνται) |
school | 1 = επιστρέφει επίσης τις περιόδους σχολικών διακοπών (school_holidays[]) για χώρες που τις δημοσιεύουν |
include | impact = προσθέτει 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[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Δευτέρα..7=Κυριακή), day_name, is_weekend (Σαββατοκύριακο της χώρας). |
data.holidays[].name | en, local (στη γλώσσα local_lang) και translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL ή REGIONAL, regions_affected (κωδικοί ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (υπολογισμένη ημερομηνία ισλαμικού ημερολογίου), note (suspended_martial_law, transferred_by_decree ή null). |
data.holidays[].floating_logic | is_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®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Ενημερώθηκε