Calendar API Sărbători Online
Sărbători publice oficiale per țară europeană — date, nume locale și tip, inclusiv lista completă de sărbători pentru fiecare țară. Alimentat de același serviciu Nager.Date / OpenHolidaysAPI (cache de 7 zile, calendar Kosovo calculat local) care alimentează pagina calendarului de sărbători nakordoni.eu și factorii calendaristici ai sistemului de predicție. O țară returnează un obiect plat; mai multe țări returnează aceeași formă înfășurată într-o listă. upcoming=1 trece la un feed plat, sortat după dată, inter-țări; compare_to trece la o comparație identic-vs-diferit pe țări, util pentru a verifica dacă o dată este o sărbătoare pe ambele părți ale unei traversări de graniță sau doar pe una.
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. |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
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"