Tatil API
Resmi tatil verileri için ücretsiz JSON API. 199 ülke, 6 dil, 2024-2030. API anahtarı gerekmez.
Uç Noktalar
/api/v1/holidays Belirli bir ülke ve yıl için resmi tatilleri getirin.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
country | Evet | ISO 3166-1 alfa-2 ülke kodu (ör. TR, US, DE) |
year | Evet | 2024-2030 arasında yıl |
type | Hayır | Türe göre filtrele: public, bank, observance, religious |
lang | Hayır | Dil: en, tr, de, es, fr, pt (varsayılan: en) |
Örnek
https://holidaycalendar.pages.dev/api/v1/holidays?country=TR&year=2026&lang=tr Yanıt
{
"holidays": [
{
"date": "2026-01-01",
"name": "Yılbaşı",
"type": "public"
},
{
"date": "2026-03-19",
"name": "Ramazan Bayramı Arifesi",
"type": "public"
}
],
"meta": {
"country": "TR",
"year": 2026,
"total": 16,
"types": { "public": 16 }
}
} /api/v1/countries Desteklenen tüm ülkeleri kodları, adları ve kıtalarıyla listeleyin.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
lang | Hayır | Ülke adları için dil (varsayılan: en) |
Örnek
https://holidaycalendar.pages.dev/api/v1/countries?lang=en /api/v1/calendar/[country].ics Bir ülke için ICS takvim dosyası indirin. Takvim uygulamalarında abonelik URL'si olarak kullanın.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
year | Hayır | Yıl (varsayılan: mevcut yıl) |
lang | Hayır | Tatil adları için dil (varsayılan: en) |
Örnek
https://holidaycalendar.pages.dev/api/v1/calendar/TR.ics?year=2026&lang=tr Hızlı Başlangıç
API anahtarı yok, kayıt yok. Sadece bir HTTP GET isteği gönderin.
const res = await fetch( 'https://holidaycalendar.pages.dev/api/v1/holidays?country=US&year=2026' ); const data = await res.json(); console.log(data.holidays);
import requests
r = requests.get(
'https://holidaycalendar.pages.dev/api/v1/holidays',
params={'country': 'US', 'year': 2026}
)
holidays = r.json()['holidays'] Ayrıntılar
Tüm uç noktalar UTF-8 kodlamasıyla JSON döndürür. ICS uç noktası text/calendar döndürür.
Yanıtlar Cache-Control başlıkları (24 saat) içerir. Tatil verileri yıl içinde nadiren değişir.
Çapraz kaynak istekleri desteklenir. API'yi doğrudan tarayıcı JavaScript'inden çağırabilirsiniz.
Makul kullanım için kesin hız sınırı yoktur. Yüksek trafikli uygulamalar için lütfen yanıtları kendi tarafınızda önbelleğe alın.
Sık Sorulan Sorular
API ücretsiz mi?
Evet. API anahtarı, kayıt veya makul kullanım için kullanım sınırı olmadan tamamen ücretsizdir.
Hangi veri formatları mevcut?
Tatil ve ülke uç noktaları için JSON, takvim akışları için ICS (iCalendar). Tüm metinler UTF-8 kodlanmıştır.
Kaç ülke destekleniyor?
6 kıtada 199 ülke ve bölge desteklenmektedir; veriler 2024-2030 yıllarını kapsamaktadır.
Ticari projelerde kullanabilir miyim?
Evet. API hem kişisel hem de ticari kullanım için ücretsizdir. Geri bağlantı takdir ederiz ancak zorunlu değildir.
Hız sınırı var mı?
Kesin bir hız sınırı yoktur, ancak yüksek trafikli uygulamalar için lütfen yanıtları önbelleğe alın. Yanıtlar 24 saatlik Cache-Control başlığı içerir.