REST API Dokumentation

API v2.1 (Empfohlen)

Die API v2.1 bietet eine klare Struktur mit dedizierten Endpunkten für jeden Standorttyp. Dies verhindert Mehrdeutigkeiten, wenn mehrere Standorte denselben Slug haben (z.B. "Hessen" als Bundesland und als Stadt).

Verfügbare Endpunkte

Beispiele: Standorte abrufen

• Alle Bundesländer:
  

  curl -H "Accept: application/json" https://www.mehr-schulferien.de/api/v2.1/federal-states

• Spezifisches Bundesland:
  

  curl -H "Accept: application/json" https://www.mehr-schulferien.de/api/v2.1/federal-states/hessen

• Alle Städte:
  

  curl -H "Accept: application/json" https://www.mehr-schulferien.de/api/v2.1/cities

Beispiele: Feriendaten abrufen

• Ferien für ein Bundesland:
  

  curl -H "Accept: application/json" https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern/periods?start_date=2024-01-01&end_date=2024-12-31

• Nur Schulferien für eine Stadt:
  

  curl -H "Accept: application/json" https://www.mehr-schulferien.de/api/v2.1/cities/muenchen/periods?type=vacation&start_date=2024-01-01&end_date=2024-12-31

• Nur Feiertage für einen Landkreis:
  

  curl -H "Accept: application/json" https://www.mehr-schulferien.de/api/v2.1/counties/muenchen-landkreis/periods?type=holiday&start_date=2024-01-01&end_date=2024-12-31

iCalendar Export

Exportieren Sie Feriendaten im iCalendar-Format (.ics) für die direkte Integration in Kalenderanwendungen:

• Schuljahr 2024/2025 für Bayern:
  

  curl 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):
  

  curl 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:
  

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

vCard Export (nur für Schulen)

Exportieren Sie Schulkontaktdaten als vCard:

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

API Response Format

Alle API v2.1 Antworten folgen einem einheitlichen JSON-Format:

{
  "data": [ /* Array von Objekten oder einzelnes Objekt */ ],
  "meta": {
    "api_version": "2.1"
  }
}

Query Parameter

Vollständige API v2.1 Dokumentation: API v2.1 Referenz auf GitHub

API v2.0 (Veraltet)

Locations

Das Model Locations wird für die Speicherung von Ländern, Bundesländern, Landkreisen, Städten und Schulen benutzt. Dabei werden die einzelnen Ebenen miteinander verknüpft.

• Daten zu Deutschland abrufen:
  

  curl -H "Content-Type: application/json" http://www.mehr-schulferien.de/api/v2.0/locations/1

• Daten zu allen Locations abrufen:
  

  curl -H "Content-Type: application/json" http://www.mehr-schulferien.de/api/v2.0/locations

Periods

Das Model Period wird zur Speicherung der einzelnen Ferien und Feiertage benutzt.

• Daten zum Eintrag mit der ID 23 abrufen:
  

  curl -H "Content-Type: application/json" http://www.mehr-schulferien.de/api/v2.0/periods/23

Holiday or Vacation Types

Das Model HolidayOrVacationType wird zur Speicherung der einzelnen Arten von Ferien und Feiertagen benutzt.

• Daten zum Eintrag mit der ID 10 abrufen:
  

  curl -H "Content-Type: application/json" http://www.mehr-schulferien.de/api/v2.0/holiday_or_vacation_types/10