API Calendario Festività Online
Festività pubbliche ufficiali per paese europeo — date, nomi locali e tipo, inclusi gli elenchi completi di festività per ogni paese. Supportato dallo stesso servizio Nager.Date / OpenHolidaysAPI (cache di 7 giorni, calendario del Kosovo calcolato localmente) che alimenta la pagina del calendario festivo di nakordoni.eu e i fattori del calendario del sistema di previsione. Un paese restituisce un oggetto flat; più paesi restituiscono la stessa struttura racchiusa in un elenco. upcoming=1 passa a un feed cross-country flat ordinato per data; compare_to passa a un confronto stesso-vs-diverso tra paesi, utile per verificare se una data è una festività su entrambi i lati di un valico di confine o solo su uno.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
country | Codice paese ISO-2, o elenco di fino a 15 codici separati da virgole, ad es. PL o PL,DE,UA. Omettere per l'insieme predefinito (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Un singolo codice restituisce un oggetto piatto; più codici restituiscono una lista. |
compare_to | Codice ISO-2 del paese o elenco separato da virgole per il confronto. Attiva la modalità di confronto: restituisce quali date festive sono condivise da TUTTI i paesi selezionati (uguali) e quali solo da alcuni (diverse, con elenchi separati di dentro/fuori per ogni data). I parametri upcoming e days si combinano con questo — restringono uguali/diversi alla finestra di date scelta invece che all'intero anno. |
year | YYYY (predefinito: anno corrente) |
upcoming | 1 = lista piatta delle prossime festività per paese nei prossimi giorni (opzionale) |
days | Orizzonte in giorni per la modalità "futuro", 1-180. Omesso o 0 significa senza limiti — tutto ciò che il servizio sottostante può vedere, quest'anno e il prossimo. |
lang | Lingua(e) per il campo nome localizzato (predefinito en), come nella pagina del calendario delle festività di nakordoni.eu con 24 lingue. Per i dati non in cache viene utilizzato il nome locale o inglese. Elenco separato da virgole, fino a 10 lingue, es. lang=en,uk,pl — il nome viene preso dalla prima lingua richiesta; ogni festività ha anche un oggetto names con chiavi basate sui codici lingua che contiene tutte le traduzioni. |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
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"