NextBreak

Dados abertos

Férias escolares para programadores

Todos os calendários escolares do NextBreak em JSON, CSV e iCal, de utilização gratuita com atribuição. Sites de viagens, aplicações escolares, casas inteligentes e investigadores são bem-vindos.

API JSON e CSV

Sem chave e sem registo. As respostas ficam em cache durante algumas horas; por favor, não ultrapasse cerca de dois pedidos por segundo.

GET https://nextbreak.app/api/v1/calendars              # every calendar (?format=csv)
GET https://nextbreak.app/api/v1/calendars/DE-BY        # one calendar (?year=2026/27, ?format=csv)
GET https://nextbreak.app/api/v1/off?date=2027-02-15    # every calendar off on a date
curl -s https://nextbreak.app/api/v1/calendars/FR-ZC | jq '.breaks[] | {name, start, end}'

Cada período de férias tem o nome em inglês e o nome local, o tipo (autumn, christmas, winter, spring, may, summer, other), o primeiro e o último dia (o fim é null quando a entidade ainda não o publicou), o ano letivo e a fonte oficial com que foi verificado.

Feeds de calendário (iCal)

Cada calendário tem um feed que se atualiza sozinho quando uma entidade altera uma data. O endereço está na página de cada calendário, em «Adicionar todas as férias ao seu calendário».

https://nextbreak.app/ical/germany-bavaria.ics
https://nextbreak.app/ical/latvia.ics

Home Assistant

Use um feed de calendário para desligar os alarmes dos dias de aulas e os horários do aquecimento durante as férias.

  1. No Home Assistant, abra Configurações → Dispositivos e serviços → Adicionar integração → Remote calendar.
  2. Cole o endereço iCal do seu calendário (por exemplo, o da Baviera acima) e dê-lhe um nome.
  3. Use a nova entidade de calendário nas automatizações: fica ativa durante as férias escolares.
# automations.yaml: no school run on school holidays
- alias: "School morning alarm"
  trigger: { platform: time, at: "06:45:00" }
  condition:
    - condition: state
      entity_id: calendar.school_holidays_bavaria
      state: "off"
  action: { service: script.school_morning }

Licença

Os dados são publicados sob a licença CC BY 4.0: utilize-os em qualquer projeto, incluindo comerciais, e indique «NextBreak (nextbreak.app)» com uma ligação.

As datas vêm das entidades educativas; as escolas podem acrescentar alguns dias próprios. Confirme a fonte antes de planear algo que não possa ser alterado.

Fontes e cobertura →