Календарь праздников — API праздников Online
Государственные, банковские, региональные, религиозные праздники и памятные дни для 51 страны (Европа + страны Персидского залива) и их регионов, 2020-2035, на основе нашего собственного движка правил праздников. Для каждого праздника указано, является ли он выходным, банковским праздником или приходится ли на школьные каникулы, был ли праздник, выпавший на выходной, перенесён на другой день, остаётся ли его дата оценочной (исламский календарь), а также действует ли в этот день запрет на движение грузовиков и в какое время. Поддерживает правило военного положения в Украине (праздники указываются, но не являются выходными) и переносы дней по указам (transfers[]). До 10 стран за один вызов; год или любой диапазон до 731 дня.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— класс квоты: cheap
| Параметр | Описание |
|---|---|
country | Код страны ISO-2 или список через запятую до 10 кодов (обязательный), например DE или DE,PL,UA |
year | YYYY, 2020-2035 (по умолчанию: текущий год). Игнорируется, если передан from/to |
from | Начало диапазона YYYY-MM-DD (вместе с to; не более 731 дня) |
to | Конец диапазона YYYY-MM-DD |
region | Регион ISO 3166-2, например DE-BY (или BY при одной стране): только государственные праздники и праздники этого региона. Если не указан — все регионы |
type | Фильтр через запятую: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE или all. По умолчанию: всё, кроме BRIDGE |
lang | Коды языков через запятую для name.translations (по умолчанию: все имеющиеся языки), например en,uk,pl |
q | Поиск по названиям праздников (на любом языке), например christmas |
id | Один праздник по id (остальные фильтры игнорируются) |
school | 1 = дополнительно выводить периоды школьных каникул (school_holidays[]) для стран, которые их публикуют |
include | impact = добавить business_intelligence к каждому празднику (Pro и выше) |
min_impact | Только праздники с impact_score не ниже указанного значения (0-100); подразумевает include=impact |
Поля ответа — внутри объекта data в конверте ответа. [] обозначает список, поэтому data.items[].name — это поле name каждого элемента. Поле бывает null, отсутствует или пустой список, если значения у нас нет, — заглушки мы не подставляем.
| Поле | Описание |
|---|---|
data.holidays[].id | Постоянный идентификатор праздника, например hol_de_christmas_day_2026 — значение, которое принимает ?id=. Перенесённые (observed) дни оканчиваются на _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=понедельник..7=воскресенье), day_name, is_weekend (выходной день страны). |
data.holidays[].name | en, local (на local_lang) и translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL или REGIONAL, regions_affected (коды ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (вычисленная дата по исламскому календарю), note (suspended_martial_law, transferred_by_decree или null). |
data.holidays[].floating_logic | is_floating, rule (правило определения даты простым языком), shifted_from (исходная дата, если праздник, выпавший на выходной, был перенесён). |
data.holidays[].truck_ban | Праздничный запрет на движение грузовиков в этой стране: applies, time_from, time_until (местное время), min_weight_tons, eve_rule {date,time_from,time_until} для запрета в канун праздника, scope_note. |
data.holidays[].business_intelligence | При include=impact на тарифе Pro и выше: тот же блок модельных оценок, который возвращает продукт impact. |
data.transfers[] | Переносы дней по указам в заданном периоде: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | При school=1: id, start_date, end_date, name, location. |
data.count | Количество возвращённых праздников; countries и window {from,to} повторяют параметры запроса. |
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"
Обновлено