Bayram təqvimi — Holidays API Online
51 ölkə (Avropa + Körfəz) və onların regionları üçün dövlət, bank, regional, dini və xatirə bayramları, 2020-2035, öz bayram qaydaları mühərrikimizdən. Hər bayram bildirir: istirahət günüdür, bank bayramıdır, yoxsa məktəb tətilinə düşür; həftə sonuna düşən bayram başqa günə keçirilib-keçirilməyib; tarixi hələ təxminidir (İslam təqvimi); həmin gün yük maşınlarının hərəkətinə qadağa tətbiq olunub-olunmur və nə vaxt. Ukraynanın hərbi vəziyyət qaydasını (bayramlar göstərilir, istirahət günü deyil) və fərmanla gün köçürmələrini (transfers[]) əhatə edir. Bir sorğuda 10 ölkəyə qədər; bir il və ya 731 günə qədər istənilən aralıq.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— kvota sinfi: cheap
| Parametr | Təsvir |
|---|---|
country | ISO-2 ölkə kodu və ya 10-a qədər kodun vergüllə ayrılmış siyahısı (məcburi), məs. DE və ya DE,PL,UA |
year | YYYY, 2020-2035 (susmaya görə: cari il). from/to göndərildikdə nəzərə alınmır |
from | Aralığın başlanğıcı YYYY-MM-DD (to ilə; ən çox 731 gün) |
to | Aralığın sonu YYYY-MM-DD |
region | ISO 3166-2 region, məs. DE-BY (və ya bir ölkə ilə BY): ümumdövlət bayramları + yalnız həmin regionun bayramları. Bütün regionlar üçün buraxın |
type | Vergüllə ayrılmış filtr: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE və ya all. Susmaya görə: BRIDGE istisna olmaqla hamısı |
lang | name.translations üçün dil kodlarının vergüllə ayrılmış siyahısı (susmaya görə: əlimizdə olan bütün dillər), məs. en,uk,pl |
q | Bayram adlarında axtarış (istənilən dildə), məs. christmas |
id | id üzrə bir bayram (digər filtrlər nəzərə alınmır) |
school | 1 = məktəb tətili dövrlərini də göstər (school_holidays[]) — onları dərc edən ölkələr üçün |
include | impact = hər bayrama business_intelligence əlavə et (Pro və yuxarı) |
min_impact | Yalnız impact_score-u ən azı bu qədər olan bayramlar (0-100); include=impact nəzərdə tutur |
Cavab sahələri — cavab zərfindəki data obyektinin içində. [] siyahını bildirir, yəni data.items[].name hər elementin name sahəsidir. Dəyəri olmayan sahə null olur, ümumiyyətlə görünmür və ya boş siyahı qaytarır — heç vaxt doldurucu qoymuruq.
| Sahə | Təsvir |
|---|---|
data.holidays[].id | Sabit bayram id-si, məs. hol_de_christmas_day_2026 — ?id= parametrinin qəbul etdiyi dəyər. Müşahidə olunan (köçürülmüş) günlər _obs ilə bitir. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Bazar ertəsi..7=Bazar), day_name, is_weekend (ölkənin həftə sonu). |
data.holidays[].name | en, local (local_lang dilində) və translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL və ya REGIONAL, regions_affected (ISO 3166-2 kodları). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (hesablanmış İslam təqvimi tarixi), note (suspended_martial_law, transferred_by_decree və ya null). |
data.holidays[].floating_logic | is_floating, rule (tarix qaydası sadə dildə), shifted_from (həftə sonu bayramı köçürüldükdə ilkin tarix). |
data.holidays[].truck_ban | Həmin ölkədə bayram günü yük maşınlarının hərəkətinə qadağa: applies, time_from, time_until (yerli vaxtla), min_weight_tons, ərəfə günü qadağa üçün eve_rule {date,time_from,time_until}, scope_note. |
data.holidays[].business_intelligence | Pro və yuxarı planlarda include=impact ilə: impact məhsulunun qaytardığı eyni model əsaslı təxmini blok. |
data.transfers[] | Pəncərədə fərmanla gün köçürmələri: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | school=1 ilə: id, start_date, end_date, name, location. |
data.count | Qaytarılan bayramların sayı; countries və window {from,to} sorğunu əks etdirir. |
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"
Yeniləndi