API Calendario de Festivos Online
Días festivos oficiales por país europeo — fechas, nombres locales y tipo, con la lista completa de festivos de cada país incluida. Respaldado por el mismo servicio Nager.Date / OpenHolidaysAPI (caché de 7 días, calendario de Kosovo calculado localmente) que alimenta la página del calendario de festivos de nakordoni.eu y los factores de calendario del sistema de predicción. Un país devuelve un objeto plano; varios devuelven la misma estructura envuelta en una lista. upcoming=1 cambia a un feed plano y ordenado por fecha entre países; compare_to cambia a una comparación mismo-vs-diferente entre países, útil para verificar si una fecha es festiva en ambos lados de un cruce fronterizo o solo en uno.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— clase de cuota: cheap
| Parámetro | Descripción |
|---|---|
country | Código de país ISO-2, o lista de hasta 15 códigos separados por comas, ej. PL o PL,DE,UA. Omitir para el conjunto predeterminado (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Un código devuelve un objeto plano; varios códigos devuelven una lista. |
compare_to | Código ISO-2 del país o lista separada por comas para comparar. Activa el modo de comparación: devuelve qué fechas festivas son compartidas por TODOS los países seleccionados (iguales) y cuáles solo por algunos (diferentes, con listas separadas de dentro/fuera para cada fecha). Los parámetros upcoming y days se combinan con esto — reducen iguales/diferentes a la ventana de fechas seleccionada en lugar del año completo. |
year | YYYY (por defecto: año actual) |
upcoming | 1 = lista plana de los próximos días festivos por países en los próximos días (opcional) |
days | Horizonte en días para el modo "próximo", 1-180. Omitido o 0 significa sin límite — todo lo que el servicio subyacente puede ver, este año y el próximo. |
lang | Idioma(s) para el campo de nombre localizado (por defecto en), igual que en la página del calendario de fiestas de nakordoni.eu con 24 idiomas. Para datos no almacenados en caché se usa el nombre local o en inglés. Lista separada por comas, hasta 10 idiomas, ej. lang=en,uk,pl — el nombre se toma del primer idioma solicitado; cada fiesta también tiene un objeto names con claves según los códigos de idioma que contiene todas las traducciones. |
Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.
| Campo | Descripción |
|---|---|
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"