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"