NextBreak

Отворени данни

Училищни ваканции за разработчици

Всички училищни календари в NextBreak във формат JSON, CSV и iCal – безплатни за използване с посочване на източника. Добре дошли са туристически сайтове, училищни приложения, умни домове и изследователи.

JSON и CSV API

Без ключ и без регистрация. Отговорите се кешират за няколко часа; моля, не правете повече от около две заявки в секунда.

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

Всяка ваканция има английско и местно име, вид (autumn, christmas, winter, spring, may, summer, other), първи и последен ден (end е null, ако институцията още не го е публикувала), учебна година и официалния източник, с който е проверена.

Абонаментни календари (iCal)

Всеки календар има абонаментен адрес, който се обновява сам, когато институцията промени дата. Адресът е на страницата на всеки календар, под „Добавете всички ваканции в календара си“.

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

Home Assistant

Използвайте абонаментен календар, за да изключвате будилниците за учебните дни и графиците на отоплението по време на ваканциите.

  1. В Home Assistant отворете Settings → Devices & services → Add integration → Remote calendar.
  2. Поставете iCal адреса на своя календар (например този за Бавария по-горе) и му дайте име.
  3. Използвайте новия календар в автоматизациите: по време на училищна ваканция състоянието му е „on“.
# 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 }

Лиценз

Данните са публикувани под лиценз CC BY 4.0: използвайте ги във всеки проект, включително търговски, като посочите „NextBreak (nextbreak.app)“ с връзка.

Датите идват от образователните институции; училищата могат да добавят няколко свои почивни дни. Проверете източника, преди да планирате нещо, което не може да се премести.

Източници и обхват →