Календар 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,pl — ім’я береться з першої заданої мови; кожен свято також має об’єкт 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"