Standorte API

← Zurück zur API-Übersicht

Die Standorte-Endpunkte ermöglichen das Abrufen von Informationen über Bundesländer, Städte, Landkreise und Schulen in Deutschland.

Verfügbare Endpunkte

Standorttyp Basis-URL Verfügbare Aktionen
Bundesländer /api/v2.1/federal-states Liste, Details
Städte /api/v2.1/cities Liste, Details
Landkreise /api/v2.1/counties Liste, Details
Schulen /api/v2.1/schools Liste, Details
Länder /api/v2.1/countries Liste, Details

Beispiele

Alle Bundesländer abrufen 

GET https://www.mehr-schulferien.de/api/v2.1/federal-states

Spezifisches Bundesland abrufen 

GET https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern

Alle Städte abrufen 

GET https://www.mehr-schulferien.de/api/v2.1/cities

Optional: Filterung nach Bundesland möglich mit ?federal_state=bayern

Schulen abrufen 

GET https://www.mehr-schulferien.de/api/v2.1/schools

Optional: Filterung mit ?city=muenchen oder ?federal_state=bayern

Response-Format

Alle Standort-Endpunkte geben JSON im folgenden Format zurück: 

{
  "data": [
    {
      "id": 2,
      "name": "Bayern",
      "slug": "bayern",
      "code": "BY",
      "type": "federal_state",
      "parent_location_id": 1,
      "links": {
        "self": "https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern",
        "periods": "https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern/periods",
        "icalendar": "https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern/icalendar"
      }
    }
  ],
  "meta": {
    "api_version": "2.1"
  }
}

Tipp: Das links-Objekt enthält URLs zu verwandten Ressourcen wie Ferien, iCalendar-Export und mehr.

Siehe auch