Skip to main content
Menu

← All endpoints

API Bayramlar Təqvimi 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 — kvota sinfi: cheap

ParametrTəsvir
countryISO-2 ölkə kodu, və ya 15-ə qədər vergüllə ayrılmış kodlar siyahısı, məs. PL və ya PL,DE,UA. Standart dəst üçün boş saxlayın (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT). Bir kod flat obyekt qaytarır; bir neçə kod isə siyahı qaytarır.
compare_toISO-2 ölkə kodu və ya vergüllə ayrılmış siyahı müqayisə üçün. Müqayisə rejiminə keçid: seçilmiş ölkələrin hamısında ümumi olan bayram tarixlərini (eyni) və yalnız bəzilərində olanları (müxtəlif, hər tarix üçün ayrıca daxil/daxil deyil siyahıları ilə) qaytarır. upcoming və days parametrləri bununla birgə işləyir — bütün il əvəzinə seçilmiş tarix aralığına uyğun olaraq eyni/müxtəlifləri daraldır.
yearYYYY (standart: cari il)
upcoming1 = ölkələr üzrə gələn günlərdəki bayramların düz siyahısı (istəyə bağlı)
daysGələcək rejimi üçün günlərdə ufq, 1-180. Buraxılış və ya 0 məhdudiyyətin olmamasını göstərir — əsas xidmətin görə bildiyi hər şey, bu il və növbəti il.
langLokal adı sahəsi üçün dil(lər) (varsayılan en), nakordoni.eu bayramlar təqvimi səhifəsi kimi 24 dildə. Keş edilməmiş verilənlər üçün yerli və ya ingilis adı istifadə olunur. Vergüllə ayrılmış siyahı, ən çox 10 dil, məsələn lang=en,uk,pl — ad ilk sorğulanan dildən götürülür; hər bayram həmçinin dil kodlarına əsaslanan names obyekti ilə təchiz olunur, bütün tərcümələri ehtiva edir.
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. Giriş