Dados abertos de feriados: JSON e ICS

Endereços (estáveis, versão 1)

Todos os arquivos são estáticos e ficam em cache por um dia. Código do país = ISO 3166-1 alfa-2 em minúsculas; códigos de região = ISO 3166-2 sem o prefixo do 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"
  ]
}

Exemplos 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'

Assinar no calendário

Os arquivos ICS contêm os feriados nacionais. Google Agenda: “Outras agendas → Do URL”; Outlook: “Adicionar calendário → Assinar da web”; iPhone: “Ajustes → Calendário → Contas → Adicionar Calendário Assinado”.

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

Como os dados são verificados

• Alemanha: calculada a partir das 16 leis estaduais de feriados e do Tratado de Unificação, com testes automáticos.
• Demais países: gerados com python-holidays e conferidos com o Nager.Date e as agendas públicas de feriados do Google. Países, anos ou regiões com divergência não estão incluídos.
• Feriados do calendário lunar levam “estimated”: a data pode variar um dia conforme a observação da lua. Sem garantia – prevalece a fonte oficial.

Férias escolares

Os arquivos JSON da Alemanha também trazem as férias escolares dos 16 estados (fonte: KMK e secretarias estaduais), conforme publicadas oficialmente.

As férias escolares de outros países (OpenHolidays API) estão em um arquivo separado sob a Open Database License (ODbL 1.0): /data/schulferien-welt.json

Encontrou um erro ou falta um país? Escreva para nós: info@saracai.de