Tatil Takvimi — Tatiller API'si Online
Kendi tatil kural motorumuzdan, 51 ülke (Avrupa + Körfez) ve bölgeleri için 2020-2035 yılları arasındaki resmi, banka, bölgesel, dini ve anma günü tatilleri. Her tatil; izin günü olup olmadığını, banka tatili olup olmadığını veya okul tatilleri içinde yer alıp almadığını, hafta sonuna denk gelen tatilin başka bir güne kaydırılıp kaydırılmadığını, tarihinin hâlâ tahmini olup olmadığını (İslami takvim) ve o gün kamyon sürüş yasağının uygulanıp uygulanmadığını ve ne zaman uygulandığını belirtir. Ukrayna'nın sıkıyönetim kuralını (tatiller listelenir, izin günü sayılmaz) ve kararname ile gün aktarmalarını (transfers[]) kapsar. Çağrı başına en fazla 10 ülke; bir yıl veya en fazla 731 günlük herhangi bir aralık.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— kota sınıfı: cheap
| Parametre | Açıklama |
|---|---|
country | ISO-2 ülke kodu veya en fazla 10 kodluk virgülle ayrılmış liste (zorunlu), örn. DE veya DE,PL,UA |
year | YYYY, 2020-2035 (varsayılan: geçerli yıl). from/to gönderildiğinde yok sayılır |
from | Aralık başlangıcı YYYY-MM-DD (to ile birlikte; en fazla 731 gün) |
to | Aralık sonu YYYY-MM-DD |
region | ISO 3166-2 bölgesi, örn. DE-BY (veya tek ülkeyle BY): ulusal tatiller + yalnızca o bölgenin tatilleri. Tüm bölgeler için boş bırakın |
type | Virgülle ayrılmış filtre: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE veya all. Varsayılan: BRIDGE dışındaki her şey |
lang | name.translations için virgülle ayrılmış dil kodları (varsayılan: sahip olduğumuz tüm diller), örn. en,uk,pl |
q | Tatil adlarında arama (herhangi bir dilde), örn. christmas |
id | Kimliğe göre tek tatil (diğer filtreler yok sayılır) |
school | 1 = okul tatili dönemlerini (school_holidays[]) yayımlayan ülkeler için bunları da listele |
include | impact = her tatile business_intelligence ekler (Pro ve üzeri) |
min_impact | Yalnızca impact_score değeri bu değerden büyük veya eşit olan tatiller (0-100); include=impact anlamına gelir |
Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.
| Alan | Açıklama |
|---|---|
data.holidays[].id | Kalıcı tatil kimliği, örn. hol_de_christmas_day_2026 — ?id= parametresinin aldığı değer. Gözlemlenen (kaydırılan) günler _obs ile biter. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Pazartesi..7=Pazar), day_name, is_weekend (ülkenin hafta sonu). |
data.holidays[].name | en, local (local_lang dilinde) ve translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL veya REGIONAL, regions_affected (ISO 3166-2 kodları). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (hesaplanmış İslami takvim tarihi), note (suspended_martial_law, transferred_by_decree veya null). |
data.holidays[].floating_logic | is_floating, rule (sade dille tarih kuralı), shifted_from (hafta sonu tatili kaydırıldığında özgün tarih). |
data.holidays[].truck_ban | İlgili ülkedeki tatil kamyon sürüş yasağı: applies, time_from, time_until (yerel saat), min_weight_tons, arife günü yasağı için eve_rule {date,time_from,time_until}, scope_note. |
data.holidays[].business_intelligence | Pro ve üzeri planlarda include=impact ile: etki ürününün döndürdüğü aynı model tahminli blok. |
data.transfers[] | Penceredeki kararname ile gün aktarmaları: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | school=1 ile: id, start_date, end_date, name, location. |
data.count | Döndürülen tatiller; countries ve window {from,to} isteği yansıtır. |
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"
Güncellendi