Календар на празници — 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=. Забележаните (преместени) денови завршуваат на _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 и повисок: истиот блок со моделна проценка што го враќа производот за влијание. |
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"
Ажурирано