Календарь праздников API Online
Официальные государственные праздники по европейским странам — даты, локальные названия и тип, полный список праздников для каждой страны. Поддерживается тем же сервисом Nager.Date / OpenHolidaysAPI (7-дневный кэш, локально вычисленный календарь Косова), который питает страницу календаря праздников nakordoni.eu и факторы календаря системы прогнозирования. Одна страна возвращает плоский объект; несколько стран возвращают ту же форму, завернутую в список. upcoming=1 переключает на плоский кросс-страновой фид, отсортированный по датам; compare_to переключает на сравнение идентичное-vs-различное по странам, полезно для проверки, является ли дата праздником с обеих сторон пересечения границы или только с одной.
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— класс квоты: cheap
| Параметр | Описание |
|---|---|
country | Код страны ISO-2, или список до 15 кодов через запятую, напр. PL или PL,DE,UA. Пропустите для набора по умолчанию (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Один код возвращает плоский объект; несколько кодов — список. |
compare_to | Код ISO-2 страны или список через запятую для сравнения. Переключает режим сравнения: возвращает, какие праздничные даты общие для ВСЕХ выбранных стран (одинаковые) и какие только для некоторых (разные, с отдельными списками в/не_в для каждой даты). Параметры upcoming и days работают с этим — сужают одинаковые/разные до выбранного окна дат вместо полного года. |
year | YYYY (по умолчанию: текущий год) |
upcoming | 1 = плоский список предстоящих праздников по странам в течение нескольких дней (необязательно) |
days | Горизонт в днях для режима "предстоящий", 1-180. Пропуск или 0 означает отсутствие ограничения — всё, что видит базовая служба, в этом году и следующем. |
lang | Язык(и) для локализованного имени поля (по умолчанию en), как на странице календаря праздников nakordoni.eu с 24 языками. Для некешированных данных используется локальное или английское название. Перечень через запятую, до 10 языков, напр. lang=en,uk,ru — имя берется из первого запрошенного языка; каждое событие также имеет объект names с ключами по кодам языков, содержащий все переводы. |
Поля ответа — внутри объекта data в конверте ответа. [] обозначает список, поэтому data.items[].name — это поле name каждого элемента. Поле бывает null, отсутствует или пустой список, если значения у нас нет, — заглушки мы не подставляем.
| Поле | Описание |
|---|---|
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"