공휴일 공개 데이터: JSON과 ICS

엔드포인트(고정, 버전 1)

모든 파일은 정적 파일이며 하루 동안 캐시됩니다. 국가 코드는 소문자 ISO 3166-1 alpha-2, 지역 코드는 국가 접두어를 뺀 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"
  ]
}

코드 예시

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'

캘린더에서 구독하기

ICS 파일에는 전국 공통 공휴일이 들어 있습니다. Google 캘린더는 "다른 캘린더 → URL로 추가", Outlook은 "캘린더 추가 → 웹에서 구독", iPhone은 "설정 → 캘린더 → 계정 → 구독 캘린더 추가"에서 등록합니다.

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

데이터 검증 방법

• 독일: 16개 주의 공휴일법과 통일 조약을 바탕으로 계산하고, 법령 원문에 대한 자동 테스트로 확인합니다.
• 그 밖의 국가: python-holidays로 생성한 뒤 Nager.Date 및 Google 공개 공휴일 캘린더와 대조합니다. 차이가 있는 국가, 연도, 지역은 여기에 포함하지 않습니다.
• 음력에 따른 공휴일에는 "estimated" 표시가 붙습니다. 달 관측 결과에 따라 날짜가 하루 달라질 수 있습니다. 정확성을 보증하지 않으며, 법적 구속력이 필요한 용도에는 공식 출처가 우선합니다.

학교 방학

독일 JSON 파일에는 공식 발표된 범위에서 16개 주 전체의 학교 방학(출처: KMK 및 각 주 교육부)도 들어 있습니다.

다른 국가의 학교 방학(OpenHolidays API 제공)은 Open Database License(ODbL 1.0)에 따라 별도 파일로 제공합니다. /data/schulferien-welt.json

관련 도구

• 주차 계산기: 오늘은 올해 몇 주차일까
• 온라인 타이머
• 온라인 스톱워치
• 뽀모도로 타이머

오류를 발견했거나 빠진 국가가 있다면 알려 주십시오. info@saracai.de