Calendar API Sărbători 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
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
country | Codul țării ISO-2, sau o listă de până la 15 coduri separate prin virgulă, ex. PL sau PL,DE,UA. Omiterea pentru setul implicit (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Un singur cod returnează un obiect simplu; mai multe coduri returnează o listă. |
compare_to | Cod ISO-2 al țării sau listă separată prin virgulă pentru comparație. Comută în modul de comparare: returnează care date de sărbători sunt comune PENTRU TOATE țările selectate (aceleași) și care doar pentru unele (diferite, cu liste separate de în/nu_în pentru fiecare dată). Parametrii upcoming și days se combină cu acesta — restrâng cele identice/diferite la fereastra de date selectată în locul întregului an. |
year | YYYY (implicit: anul curent) |
upcoming | 1 = listă simplă a sărbătorilor viitoare pe țări pentru câteva zile (opțional) |
days | Orizont în zile pentru modul "viitor", 1-180. Omiterea sau 0 înseamnă fără limită — tot ce poate vedea serviciul subiacent, în acest an și următorul. |
lang | Limba(e) pentru câmpul de nume localizat (implicit en), la fel ca pe pagina de calendar a sărbătorilor nakordoni.eu cu 24 de limbi. Pentru datele ne-cache, se folosește numele local sau cel englezesc. Listă separată prin virgulă, până la 10 limbi, ex. lang=en,uk,pl — numele este preluat din prima limbă solicitată; fiecare sărbătoare are și un obiect names cu chei după codurile limbilor, care conține toate traducerile. |
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. Autentificare