Calendario dei giorni festivi — API Festività Online
Festività pubbliche, bancarie, regionali, religiose e ricorrenze per 51 paesi (Europa + Golfo) e le rispettive regioni, 2020-2035, generate dal nostro motore di regole delle festività. Ogni festività indica se è un giorno non lavorativo, una festività bancaria o se ricade nelle vacanze scolastiche, se una festività che cade nel fine settimana è stata spostata a un altro giorno, se la sua data è ancora stimata (calendario islamico) e se in quel giorno vale un divieto di circolazione per i camion e in quale fascia oraria. Include la regola della legge marziale dell'Ucraina (festività elencate, non giorni non lavorativi) e i trasferimenti di giorni per decreto (transfers[]). Fino a 10 paesi per chiamata; un anno o qualsiasi intervallo fino a 731 giorni.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
country | Codice paese ISO-2, o elenco separato da virgole fino a 10 (obbligatorio), ad es. DE o DE,PL,UA |
year | YYYY, 2020-2035 (predefinito: anno corrente). Ignorato se si inviano from/to |
from | Inizio intervallo YYYY-MM-DD (con to; al massimo 731 giorni) |
to | Fine intervallo YYYY-MM-DD |
region | Regione ISO 3166-2, ad es. DE-BY (o BY con un solo paese): festività nazionali + solo quelle di tale regione. Omettere per tutte le regioni |
type | Filtro separato da virgole: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE, oppure all. Predefinito: tutto tranne BRIDGE |
lang | Codici lingua separati da virgole per name.translations (predefinito: tutte le lingue disponibili), ad es. en,uk,pl |
q | Ricerca nei nomi delle festività (qualsiasi lingua), ad es. christmas |
id | Una festività per id (gli altri filtri vengono ignorati) |
school | 1 = elenca anche i periodi di vacanza scolastica (school_holidays[]) per i paesi che li pubblicano |
include | impact = aggiunge business_intelligence a ogni festività (Pro e superiori) |
min_impact | Solo festività con un impact_score pari ad almeno questo valore (0-100); implica include=impact |
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.holidays[].id | ID stabile della festività, ad es. hol_de_christmas_day_2026 — il valore accettato da ?id=. I giorni osservati (spostati) terminano con _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=lunedì..7=domenica), day_name, is_weekend (fine settimana del paese). |
data.holidays[].name | en, local (in local_lang) e translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL o REGIONAL, regions_affected (codici ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (data calcolata nel calendario islamico), note (suspended_martial_law, transferred_by_decree o null). |
data.holidays[].floating_logic | is_floating, rule (regola della data in linguaggio semplice), shifted_from (data originale quando una festività del fine settimana è stata spostata). |
data.holidays[].truck_ban | Divieto di circolazione dei camion nei giorni festivi in quel paese: applies, time_from, time_until (ora locale), min_weight_tons, eve_rule {date,time_from,time_until} per un divieto alla vigilia, scope_note. |
data.holidays[].business_intelligence | Con include=impact nei piani Pro e superiori: lo stesso blocco stimato dal modello restituito dal prodotto impact. |
data.transfers[] | Trasferimenti di giorni per decreto nell'intervallo: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Con school=1: id, start_date, end_date, name, location. |
data.count | Festività restituite; countries e window {from,to} ripetono la richiesta. |
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"
Aggiornato