API Calendrier des jours fériés Online
Jours fériés officiels par pays européen — dates, noms locaux et type, liste complète des jours fériés de chaque pays incluse. Alimenté par le même service Nager.Date / OpenHolidaysAPI (cache de 7 jours, calendrier du Kosovo calculé localement) qui alimente la page du calendrier des jours fériés de nakordoni.eu et les facteurs de calendrier du système de prédiction. Un seul pays renvoie un objet plat ; plusieurs renvoient la même forme encapsulée dans une liste. upcoming=1 bascule vers un flux de pays croisés aplati et trié par date ; compare_to bascule vers une comparaison même-vs-différent entre pays, utile pour vérifier si une date est un jour férié des deux côtés d'une traversée frontalière ou d'un seul.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— classe de quota: cheap
| Paramètre | Description |
|---|---|
country | Code pays ISO-2, ou liste de jusqu'à 15 codes séparés par des virgules, p. ex. PL ou PL,DE,UA. Omettre pour l'ensemble par défaut (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Un code unique retourne un objet plat ; plusieurs codes retournent une liste. |
compare_to | Code ISO-2 de pays, ou liste séparée par des virgules, pour comparaison. Passe en mode comparaison : retourne les dates de jours fériés communes à TOUS les pays sélectionnés (identiques) et celles qui ne le sont que pour certains (différentes, avec des listes séparées de dans/non_dans pour chaque date). Les paramètres upcoming et days s'appliquent ici — ils restreignent les dates identiques/différentes à la fenêtre de dates choisie au lieu de l'année complète. |
year | YYYY (par défaut : année en cours) |
upcoming | 1 = liste plate des prochaines fêtes par pays sur quelques jours (facultatif) |
days | Horizon en jours pour le mode "à venir", 1-180. Omis ou 0 signifie aucune limite — tout ce que le service sous-jacent peut voir, cette année et l'année prochaine. |
lang | Langue(s) pour le champ de nom localisé (par défaut en), comme sur la page du calendrier des fêtes de nakordoni.eu avec 24 langues. Pour les données non mises en cache, le nom local ou anglais est utilisé. Liste séparée par des virgules, jusqu'à 10 langues, ex. lang=en,uk,pl — le nom est pris depuis la première langue demandée; chaque fête possède aussi un objet names avec des clés basées sur les codes de langue contenant toutes les traductions. |
Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.
| Champ | Description |
|---|---|
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"