Datos abiertos de días festivos: JSON e ICS

Direcciones (estables, versión 1)

Todos los archivos son estáticos y se almacenan en caché un día. Código de país = ISO 3166-1 alfa-2 en minúsculas; códigos de región = ISO 3166-2 sin prefijo de país.

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

Ejemplos de código

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'

Suscribirse en el calendario

Los archivos ICS contienen los festivos nacionales. Google Calendar: «Otros calendarios → Desde URL»; Outlook: «Agregar calendario → Suscribirse desde la web»; iPhone: «Ajustes → Calendario → Cuentas → Añadir calendario suscrito».

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

Cómo se comprueban los datos

• Alemania: calculada a partir de las 16 leyes regionales de festivos y del Tratado de Unificación, con pruebas automáticas.
• Resto de países: generados con python-holidays y contrastados con Nager.Date y los calendarios públicos de festivos de Google. Los países, años o regiones con discrepancias no se incluyen.
• Las fiestas del calendario lunar llevan «estimated»: la fecha puede variar un día según el avistamiento de la luna. Sin garantía: prevalece la fuente oficial.

Vacaciones escolares

Los archivos JSON de Alemania incluyen además las vacaciones escolares de los 16 estados federados (fuente: KMK y ministerios regionales), en la medida en que estén publicadas.

Las vacaciones escolares de otros países (OpenHolidays API) están en un archivo aparte bajo la Open Database License (ODbL 1.0): /data/schulferien-welt.json

¿Has encontrado un error o falta un país? Escríbenos: info@saracai.de