Календар на празниците — API за празници Online
Официални, банкови, регионални, религиозни и отбелязвани празници за 51 държави (Европа + Персийски залив) и техните региони, 2020-2035, от нашия собствен механизъм с правила за празници. Всеки празник показва дали е почивен ден, банков празник или попада в училищна ваканция, дали празник в почивен ден е преместен на друг ден, дали датата му все още е приблизителна (ислямски календар) и дали в този ден важи забрана за движение на камиони и кога. Обхваща правилото за военно положение в Украйна (празниците са изброени, но не са почивни дни) и преместванията на дни по указ (transfers[]). До 10 държави на заявка; една година или произволен период до 731 дни.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— клас квота: cheap
| Параметър | Описание |
|---|---|
country | Двубуквен ISO код на държава или списък до 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"
Обновено