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 (по default: тековна година) |
upcoming | 1 = рамна листа на предстојните празници по земји во неколку дена (опционално) |
days | Хоризонт во денови за режимот „идни“, 1-180. Исклучување или 0 значи без ограничување — сè што ја гледа основната услуга, оваа година и следната. |
lang | Јазик(и) за локализираното име на полето (по default 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"