Календар свят — 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 | Одне свято за ідентифікатором (інші фільтри ігноруються) |
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"
Оновлено