API Календар за празници Online
Official public holidays per European country — dates, local names and type, each country's full holiday list included. Backed by the same Nager.Date / OpenHolidaysAPI service (7-day cache, locally-computed Kosovo calendar) that powers the nakordoni.eu holiday calendar page and the prediction system's calendar factors. One country returns a flat object; several return the same shape wrapped in a list. upcoming=1 switches to a flat, date-sorted cross-country feed; compare_to switches to a same-vs-different comparison across countries, useful for checking whether a date is a holiday on both sides of a border crossing or just one.
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 с ключове по кодовете на езиците, съдържащ всички преводи. |
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"
🔑 Log in as a developer to try this endpoint live in the sandbox — 50 free test calls a day. Вход