NextBreak

Otwarte dane

Ferie szkolne dla programistów

Wszystkie kalendarze szkolne z NextBreak w formatach JSON, CSV i iCal – do bezpłatnego wykorzystania z podaniem źródła. Zapraszamy serwisy turystyczne, aplikacje szkolne, inteligentne domy i badaczy.

API JSON i CSV

Bez klucza i bez rejestracji. Odpowiedzi są przechowywane w pamięci podręcznej przez kilka godzin; prosimy o nie więcej niż ok. dwa zapytania na sekundę.

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

Każda przerwa ma nazwę angielską i lokalną, rodzaj (autumn, christmas, winter, spring, may, summer, other), pierwszy i ostatni dzień (end ma wartość null, jeśli instytucja jeszcze go nie opublikowała), rok szkolny oraz oficjalne źródło, z którym ją porównano.

Kanały kalendarza (iCal)

Każdy kalendarz ma kanał, który aktualizuje się sam, gdy instytucja zmieni termin. Adres znajdziesz na stronie każdego kalendarza w sekcji „Dodaj wszystkie terminy do kalendarza”.

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

Home Assistant

Użyj kanału kalendarza, aby w czasie ferii wyłączać budziki na dni szkolne i harmonogramy ogrzewania.

  1. W Home Assistant otwórz Ustawienia → Urządzenia oraz usługi → Dodaj integrację → Remote calendar.
  2. Wklej adres iCal swojego kalendarza (np. ten dla Bawarii powyżej) i nadaj mu nazwę.
  3. Użyj nowej encji kalendarza w automatyzacjach: jest włączona w czasie ferii szkolnych.
# 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 }

Licencja

Dane są publikowane na licencji CC BY 4.0: możesz ich używać w dowolnym projekcie, także komercyjnym, podając źródło „NextBreak (nextbreak.app)” wraz z odnośnikiem.

Terminy pochodzą od władz oświatowych; szkoły mogą dodać kilka własnych dni wolnych. Zanim zaplanujesz coś, czego nie da się przesunąć, sprawdź źródło.

Źródła i zasięg →