Kalendarz świąt — API świąt Online
Święta państwowe, bankowe, regionalne, religijne i okolicznościowe dla 51 krajów (Europa + Zatoka Perska) oraz ich regionów, 2020-2035, z naszego własnego silnika reguł świąt. Każde święto zawiera informację, czy jest dniem wolnym, świętem bankowym lub czy przypada w czasie ferii szkolnych, czy święto przypadające w weekend zostało przeniesione na inny dzień, czy jego data jest nadal szacunkowa (kalendarz islamski) oraz czy tego dnia obowiązuje zakaz ruchu ciężarówek i w jakich godzinach. Obejmuje regulację stanu wojennego na Ukrainie (święta wymienione, ale nie są dniami wolnymi) oraz przeniesienia dni na podstawie dekretu (transfers[]). Do 10 krajów w jednym wywołaniu; rok lub dowolny zakres do 731 dni.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
country | Kod kraju ISO-2 lub lista rozdzielona przecinkami do 10 kodów (wymagane), np. DE lub DE,PL,UA |
year | YYYY, 2020-2035 (domyślnie: bieżący rok). Ignorowany, gdy przesłano from/to |
from | Początek zakresu YYYY-MM-DD (razem z to; maksymalnie 731 dni) |
to | Koniec zakresu YYYY-MM-DD |
region | Region ISO 3166-2, np. DE-BY (lub BY z jednym krajem): święta ogólnokrajowe + wyłącznie święta tego regionu. Pomiń, aby uzyskać wszystkie regiony |
type | Filtr rozdzielany przecinkami: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE lub all. Domyślnie: wszystko oprócz BRIDGE |
lang | Kody języków rozdzielone przecinkami dla name.translations (domyślnie: wszystkie posiadane języki), np. en,uk,pl |
q | Wyszukiwanie w nazwach świąt (w dowolnym języku), np. christmas |
id | Jedno święto według identyfikatora (pozostałe filtry są ignorowane) |
school | 1 = wyświetl także okresy ferii szkolnych (school_holidays[]) dla krajów, które je publikują |
include | impact = dodaj business_intelligence do każdego święta (Pro i wyższy) |
min_impact | Tylko święta z impact_score co najmniej równym tej wartości (0-100); implikuje include=impact |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
data.holidays[].id | Stabilny identyfikator święta, np. hol_de_christmas_day_2026 — wartość przyjmowana przez ?id=. Dni przeniesione (observed) kończą się na _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=poniedziałek..7=niedziela), day_name, is_weekend (weekend w danym kraju). |
data.holidays[].name | en, local (w języku local_lang) oraz translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL lub REGIONAL, regions_affected (kody ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (obliczona data według kalendarza islamskiego), note (suspended_martial_law, transferred_by_decree lub null). |
data.holidays[].floating_logic | is_floating, rule (reguła wyznaczania daty w języku potocznym), shifted_from (pierwotna data, gdy święto weekendowe zostało przeniesione). |
data.holidays[].truck_ban | Świąteczny zakaz ruchu ciężarówek w danym kraju: applies, time_from, time_until (czas lokalny), min_weight_tons, eve_rule {date,time_from,time_until} dla zakazu w przeddzień, scope_note. |
data.holidays[].business_intelligence | Z include=impact w planie Pro i wyższym: ten sam blok z szacunkami modelu, który zwraca produkt impact. |
data.transfers[] | Przeniesienia dni na podstawie dekretu w danym oknie: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Z school=1: id, start_date, end_date, name, location. |
data.count | Liczba zwróconych świąt; countries i window {from,to} powtarzają zapytanie. |
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"
Zaktualizowano