Bayramlar kalendari — Bayramlar API Online
51 davlat (Yevropa + Fors ko'rfazi) va ularning hududlari uchun davlat, bank, hududiy, diniy va xotira bayramlari, 2020-2035, o'zimizning bayram qoidalari mexanizmidan. Har bir bayram dam olish kuni ekanini, bank bayrami yoki maktab ta'tillari ichida ekanini, dam olish kuniga to'g'ri kelgan bayram boshqa kunga ko'chirilgan-ko'chirilmaganini, sanasi hali taxminiy ekanini (hijriy kalendar) hamda o'sha kuni yuk mashinalari harakatiga taqiq amal qilish-qilmasligini va qachon ekanini ko'rsatadi. Ukrainaning harbiy holat qoidasini (bayramlar ro'yxatda, dam olish kuni emas) va farmon bilan kunlar ko'chirilishini (transfers[]) qamrab oladi. Bir so'rovda 10 tagacha davlat; bir yil yoki 731 kungacha istalgan oraliq.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— kvota sinfi: cheap
| Parametr | Tavsif |
|---|---|
country | ISO-2 davlat kodi yoki 10 tagacha vergul bilan ajratilgan ro'yxat (majburiy), masalan DE yoki DE,PL,UA |
year | YYYY, 2020-2035 (standart: joriy yil). from/to yuborilganda e'tiborga olinmaydi |
from | Oraliq boshi YYYY-MM-DD (to bilan; ko'pi bilan 731 kun) |
to | Oraliq oxiri YYYY-MM-DD |
region | ISO 3166-2 hudud, masalan DE-BY (yoki bitta davlat bilan BY): umummilliy bayramlar + faqat shu hududnikilari. Barcha hududlar uchun bo'sh qoldiring |
type | Vergul bilan ajratilgan filtr: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE yoki all. Standart: BRIDGE dan tashqari hammasi |
lang | name.translations uchun vergul bilan ajratilgan til kodlari (standart: bizda mavjud barcha tillar), masalan en,uk,pl |
q | Bayram nomlaridan qidirish (istalgan tilda), masalan christmas |
id | Identifikator bo'yicha bitta bayram (boshqa filtrlar e'tiborga olinmaydi) |
school | 1 = ma'lumot e'lon qiladigan davlatlar uchun maktab ta'tili davrlarini ham (school_holidays[]) ro'yxatga kiritadi |
include | impact = har bir bayramga business_intelligence qo'shadi (Pro va undan yuqori) |
min_impact | Faqat impact_score qiymati kamida shuncha bo'lgan bayramlar (0-100); include=impact ni nazarda tutadi |
Javob maydonlari — javob konvertidagi data obyekti ichida. [] ro‘yxatni bildiradi, ya’ni data.items[].name har bir elementning name maydonidir. Qiymatimiz bo‘lmagan maydon null bo‘ladi, umuman bo‘lmaydi yoki bo‘sh ro‘yxat qaytadi — o‘rniga hech qachon soxta qiymat qo‘ymaymiz.
| Maydon | Tavsif |
|---|---|
data.holidays[].id | Barqaror bayram identifikatori, masalan hol_de_christmas_day_2026 — ?id= qabul qiladigan qiymat. Ko'chirilgan (kuzatiladigan) kunlar _obs bilan tugaydi. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=dushanba..7=yakshanba), day_name, is_weekend (davlatning dam olish kunlari). |
data.holidays[].name | en, local (local_lang tilida) va translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL yoki REGIONAL, regions_affected (ISO 3166-2 kodlari). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (hijriy kalendar bo'yicha hisoblangan sana), note (suspended_martial_law, transferred_by_decree yoki null). |
data.holidays[].floating_logic | is_floating, rule (sana qoidasi oddiy tilda), shifted_from (dam olish kuniga to'g'ri kelgan bayram ko'chirilganda asl sana). |
data.holidays[].truck_ban | Bayram kunida o'sha davlatda yuk mashinalari harakatiga taqiq: applies, time_from, time_until (mahalliy vaqt), min_weight_tons, bayram arafasidagi taqiq uchun eve_rule {date,time_from,time_until}, scope_note. |
data.holidays[].business_intelligence | Pro va undan yuqori tarifda include=impact bilan: ta'sir mahsuloti qaytaradigan model bo'yicha baholangan o'sha blok. |
data.transfers[] | Oraliqdagi farmon bilan kunlar ko'chirilishi: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | school=1 bilan: id, start_date, end_date, name, location. |
data.count | Qaytarilgan bayramlar soni; countries va window {from,to} so'rovni aks ettiradi. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Yangilandi