API Календар за празници Online
Официални публични празници по европейска държава — дати, местни имена и тип, пълният списък с празници за всяка държава е включен. Подкрепено от същата услуга Nager.Date / OpenHolidaysAPI (7-дневен кеш, локално изчислен календар на Косово), която захранва страницата на календара с празници на nakordoni.eu и факторите на календара на системата за прогнозиране. Една държава връща плосък обект; няколко връщат същата форма, обвита в списък. upcoming=1 превключва към плосък, сортиран по дата кръстогосударствен канал; compare_to превключва към еднаква-различно сравнение между държави, полезно за проверка дали дата е празник от двете страни на граничен преход или само на една.
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"