Data terbuka hari libur: JSON dan ICS

Alamat (tetap, versi 1)

Semua file bersifat statis dan di-cache selama satu hari. Kode negara = ISO 3166-1 alpha-2 huruf kecil, kode wilayah = ISO 3166-2 tanpa awalan negara.

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"
  ]
}

Contoh kode

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'

Berlangganan di kalender

File ICS berisi hari libur yang berlaku secara nasional. Google Kalender: “Kalender lain → Dari URL”; Outlook: “Tambahkan kalender → Berlangganan dari web”; iPhone: “Pengaturan → Kalender → Akun → Tambah Kalender Langganan”.

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

Cara data diperiksa

• Jerman: dihitung dari 16 undang-undang hari libur negara bagian dan Perjanjian Unifikasi, diuji otomatis terhadap teks hukum.
• Negara lain: dibuat dengan python-holidays dan dicocokkan dengan Nager.Date serta kalender hari libur publik Google. Negara, tahun, atau wilayah yang berbeda hasilnya tidak disertakan.
• Hari libur berdasarkan kalender bulan ditandai “estimated”: tanggal bisa bergeser satu hari tergantung pengamatan hilal. Tanpa jaminan – sumber resmi yang berlaku.

Libur sekolah

File JSON untuk Jerman juga memuat libur sekolah ke-16 negara bagian (sumber: KMK dan kementerian negara bagian), sejauh sudah diumumkan resmi.

Libur sekolah negara lain (OpenHolidays API) tersedia dalam file terpisah berlisensi Open Database License (ODbL 1.0): /data/schulferien-welt.json

Menemukan kesalahan atau negara yang belum ada? Tulis kepada kami: info@saracai.de