Açık resmi tatil verisi: JSON ve ICS

Adresler (sabit, sürüm 1)

Tüm dosyalar statiktir ve bir gün önbelleğe alınır. Ülke kodu = küçük harfle ISO 3166-1 alpha-2, bölge kodları = ülke öneki olmadan ISO 3166-2.

https://toolboxday.com/data/v1/holidays/index.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.json
https://toolboxday.com/data/v1/holidays/{country}/{year}.ics

index.json · /data/v1/holidays/de/2027.json · /data/v1/holidays/fr/2027.ics

{
  "date": "2027-01-06",
  "id": "heiligeDreiKoenige",
  "name": "Epiphany",
  "localName": "Heilige Drei Könige",
  "nationwide": false,
  "regions": [
    "BW",
    "BY",
    "ST"
  ]
}

Örnek kod

JavaScript

const res = await fetch('https://toolboxday.com/data/v1/holidays/de/2027.json');
const data = await res.json();
// nationwide holidays + holidays of one state (e.g. Bavaria = "BY")
const byState = data.holidays.filter(
  (h) => h.nationwide || h.regions?.includes('BY')
);
console.log(byState.map((h) => `${h.date} ${h.name}`));

Python

import json, urllib.request

url = "https://toolboxday.com/data/v1/holidays/de/2027.json"
data = json.load(urllib.request.urlopen(url))
for h in data["holidays"]:
    where = "nationwide" if h["nationwide"] else ", ".join(h["regions"])
    print(h["date"], h["name"], "-", where)

curl + jq

curl -s https://toolboxday.com/data/v1/holidays/de/2027.json | jq '.holidays[] | select(.nationwide) | .date'

Takviminize abone olun

ICS dosyaları ülke genelindeki resmi tatilleri içerir. Google Takvim: “Diğer takvimler → URL ile”; Outlook: “Takvim ekle → Web’den abone ol”; iPhone: “Ayarlar → Takvim → Hesaplar → Abone Olunan Takvim Ekle”.

https://toolboxday.com/data/v1/holidays/fr/2027.ics

Veriler nasıl doğrulanıyor

• Almanya: 16 eyaletin tatil yasalarından ve Birleşme Antlaşması’ndan hesaplanır, otomatik testlerle denetlenir.
• Diğer ülkeler: python-holidays ile üretilir; Nager.Date ve Google’ın herkese açık tatil takvimleriyle karşılaştırılır. Farklılık görülen ülke, yıl veya bölgeler dahil edilmez.
• Ay takvimine göre belirlenen bayramlarda “estimated” yazar: tarih, hilalin görülmesine göre bir gün kayabilir. Garanti verilmez – bağlayıcı olan resmi kaynaktır.

Okul tatilleri

Almanya’nın JSON dosyalarında 16 eyaletin okul tatilleri de yer alır (kaynak: KMK ve eyalet bakanlıkları), resmi olarak yayımlandığı ölçüde.

Diğer ülkelerin okul tatilleri (OpenHolidays API) ayrı bir dosyada, Open Database License (ODbL 1.0) ile sunulur: /data/schulferien-welt.json

Bir hata mı buldunuz ya da bir ülke mi eksik? Bize yazın: info@saracai.de