Export-Formate API

← Zurück zur API-Übersicht

Die Export-Endpunkte ermöglichen das Exportieren von Ferien- und Feiertagsdaten in verschiedenen Formaten für die Integration in Kalenderanwendungen und Adressbücher.

iCalendar Export

Exportieren Sie Feriendaten im iCalendar-Format (.ics) für die direkte Integration in Kalenderanwendungen wie Apple Kalender, Google Calendar, Outlook und andere.

Verfügbare Endpunkte

Endpunkt Beschreibung
/api/v2.1/federal-states/:slug/icalendar iCalendar für ein Bundesland
/api/v2.1/cities/:slug/icalendar iCalendar für eine Stadt
/api/v2.1/counties/:slug/icalendar iCalendar für einen Landkreis
/api/v2.1/schools/:slug/icalendar iCalendar für eine Schule

Query-Parameter

Parameter Standard Beschreibung
year Aktuelles Jahr Jahr für den Export
vacation_types school school (nur Schulferien) oder all (Ferien + Feiertage)
calendar_year false true für Kalenderjahr (Jan-Dez), false für Schuljahr (Aug-Jul)

Beispiele

Schuljahr 2024/2025 für Bayern (nur Schulferien):

GET https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern/icalendar?year=2024&vacation_types=school

Kalenderjahr 2024 für München (alle Ferien & Feiertage):

GET https://www.mehr-schulferien.de/api/v2.1/cities/muenchen/icalendar?year=2024&vacation_types=all&calendar_year=true

Nur Schulferien für eine spezifische Schule:

GET https://www.mehr-schulferien.de/api/v2.1/schools/gymnasium-muenchen-nord/icalendar?year=2024&vacation_types=school

Tipp: Die iCalendar-Dateien können direkt in Kalenderanwendungen importiert oder als Abonnement-URL verwendet werden. Der Content-Type ist text/calendar; charset=utf-8.

vCard Export (nur für Schulen)

Exportieren Sie Schulkontaktdaten als vCard (.vcf) für die Integration in Adressbücher und Kontaktverwaltungssysteme.

Endpunkt 

GET /api/v2.1/schools/:slug/vcard

Beispiel 

GET https://www.mehr-schulferien.de/api/v2.1/schools/gymnasium-muenchen-nord/vcard

Enthaltene Informationen

  • Schulname
  • Adresse (Straße, PLZ, Stadt)
  • Telefonnummer (falls vorhanden)
  • Faxnummer (falls vorhanden)
  • E-Mail-Adresse (falls vorhanden)
  • Website-URL (falls vorhanden)
  • Geografische Koordinaten (falls vorhanden)

Hinweis: Der vCard-Export ist nur für Schulen verfügbar. Der Content-Type ist text/vcard; charset=utf-8.

Siehe auch