Skip to content
Mähbarkeitsindex (MFI)

Mähbarkeitsindex API Regelwerk – Nutzung, Limits und API-Key Regeln

Die Mähbarkeitsindex API darf nur mit einem persönlichen API-Key verwendet werden, der an eine E-Mail-Adresse gebunden ist und ausschließlich für eine einzelne Anwendung genutzt werden darf. Requests sind auf maximal 1 Abfrage pro 5 Minuten, 15 pro Stunde und 360 pro Tag begrenzt. Alle Anfragen müssen über HTTPS erfolgen. Verstöße gegen diese Regeln können zur temporären Sperrung oder Deaktivierung des API-Zugangs führen.

Grundlagen

Was ist die Mähbarkeitsindex API?

Grundsätzlich möglich – aber mit Einschränkungen

Die Mähbarkeitsindex API (MFI API) ermöglicht es Entwicklern, den aktuellen Mähbarkeitsindex automatisiert in Anwendungen zu integrieren. Der Index bewertet anhand meteorologischer Parameter, ob Rasenflächen aktuell gemäht werden können.

Die Berechnung des Index basiert auf mehreren Umweltfaktoren wie Temperatur, Niederschlag, Bodenfeuchte, Wind und Luftfeuchtigkeit. Diese Parameter beeinflussen maßgeblich die Mähbedingungen für Rasenflächen.

Die beste Uhrzeit zum Rasen mähen im Sommer

Der Mähbarkeitsindex dient als Entscheidungsgrundlage für:

  • private Rasenpflege
  • kommunale Grünflächenpflege
  • Sportplatzpflege
  • automatisierte Garten- oder Smart-Home-Systeme

Weitere Grundlagen zum Modell findest du auf der Seite: Grundlagen des Mähbarkeitsindex (MFI).

Ziel der API

Die API stellt eine standardisierte Schnittstelle bereit, über die Anwendungen aktuelle Mähbedingungen abrufen können. Dadurch kann der Mähbarkeitsindex beispielsweise in folgende Systeme integriert werden:

  • Wetter-Websites
  • Garten-Apps
  • Smart-Garden Systeme
  • kommunale Planungssysteme
  • automatisierte Bewässerungs- oder Mähsysteme
API-Key Regeln

API-Key Registrierung

Für die Nutzung der Mähbarkeitsindex API ist ein persönlicher API-Key erforderlich. Jeder API-Key ist eindeutig einer E-Mail-Adresse zugeordnet. Es gelten folgende Regeln:

  • eine E-Mail-Adresse kann nur einen API-Key erhalten
  • der API-Key ist personenbezogen
  • API-Keys dürfen nicht öffentlich weitergegeben werden

Nutzung pro Anwendung

Ein API-Key darf ausschließlich für eine einzelne Anwendung verwendet werden. Beispiele:

  • eine Website
  • eine mobile App
  • ein Server-Backend
  • ein Smart-Home-System

Wer mehrere Projekte betreibt, benötigt entsprechend mehrere API-Keys.

Diese Regel verhindert, dass einzelne Anwendungen unverhältnismäßig viele API-Requests verursachen.

Rate Limit

Rate Limits der Mähbarkeitsindex API

Die Mähbarkeitsindex API ist bewusst limitiert, um eine stabile und faire Nutzung für alle Entwickler zu gewährleisten. Das Wetter verändert sich in der Regel nicht innerhalb weniger Minuten so stark, dass häufigere Abfragen notwendig wären. Daher gelten folgende Request-Limits.

5 Minuten

Minimaler Abstand

Zwischen zwei API-Requests müssen mindestens 5 Minuten liegen. Häufigere Anfragen sind nicht erlaubt.

15 Requests

Pro Stunde

Innerhalb einer Stunde sind maximal 15 API-Anfragen erlaubt.

360 Requests

Pro Tag

Pro API-Key dürfen maximal 360 Requests pro Tag durchgeführt werden.

Caching

Empfohlene Nutzung

Anwendungen sollten die API-Antwort lokal zwischenspeichern. Dadurch wird unnötiger Traffic vermieden und die Systemstabilität verbessert.

Testphase

Erhöhte Limits

Neue API-Nutzer können die Mähbarkeitsindex API zunächst umfangreicher testen. Innerhalb der ersten 6 Stunden nach Erstellung eines API-Keys sind bis zu 10 Requests pro Minute erlaubt. Diese erhöhte Abfragerate dient ausschließlich dazu, Integrationen zu entwickeln und zu prüfen. Nach Ablauf der Testphase gelten automatisch wieder die regulären Rate Limits der API.

Limit-Verstöße

Automatische Sperre

Wenn die Rate Limits überschritten werden, kann der API-Zugang temporär blockiert werden.

Technische Anforderungen

Technische Anforderungen

HTTPS Pflicht

Alle API-Requests müssen über HTTPS erfolgen. Unverschlüsselte HTTP-Requests werden aus Sicherheitsgründen nicht unterstützt.

Identifizierbare Anwendungen

API-Anfragen sollten möglichst einen identifizierbaren User-Agent enthalten. Dadurch kann bei Problemen schneller analysiert werden, welche Anwendung die Anfragen verursacht.

API-Versionierung und Dokumentationspflicht

Die Mähbarkeitsindex API wird versioniert bereitgestellt (z. B. /api/v1/...). Dadurch können neue Funktionen oder Änderungen eingeführt werden, ohne bestehende Integrationen unmittelbar zu beeinträchtigen.

Entwickler sind selbst dafür verantwortlich, die aktuelle API-Dokumentation regelmäßig zu prüfen und ihre Implementierungen auf dem neuesten Stand zu halten. Veraltete API-Versionen oder Endpunkte können nach einer Übergangsfrist eingeschränkt oder vollständig abgeschaltet werden.

Es wird daher empfohlen, Anwendungen regelmäßig zu aktualisieren und die jeweils aktuelle Version der API zu verwenden, um eine dauerhafte Funktionsfähigkeit sicherzustellen.

Regelverstöße

Konsequenzen bei Regelverstößen

Die Nutzung der API setzt die Einhaltung aller technischen und organisatorischen Regeln voraus. Bei Verstößen können folgende Maßnahmen erfolgen:

  • temporäre API-Sperrung
  • temporäre Erhöhung des Rate Limit
  • dauerhafte Deaktivierung des API-Keys
  • Einschränkung der Zugriffsmöglichkeiten

Typische Gründe für eine Sperrung sind:

  • Überschreitung der Rate Limits
  • automatisierte Massenzugriffe
  • Nutzung eines API-Keys für mehrere Anwendungen
  • Weitergabe des API-Keys an Dritte

Im Falle eines Regelverstoßes oder technischer Schutzmaßnahmen erfolgt in der Regel keine vorherige individuelle Benachrichtigung. Maßnahmen wie temporäre Sperrungen oder Deaktivierungen können automatisiert umgesetzt werden, um die Stabilität und Sicherheit der API zu gewährleisten.

Datenlöschung

Löschung von API-Keys und Daten

Nutzer können jederzeit die Löschung ihres API-Keys und der zugehörigen Daten beantragen. Die Anfrage kann über folgende Wege gestellt werden:

Nach erfolgreicher Löschung wird der API-Key dauerhaft deaktiviert und kann nicht mehr verwendet werden.

Haftung

Haftung und Datenverwendung

Der Mähbarkeitsindex dient als meteorologische Entscheidungshilfe für Mähbedingungen. Die bereitgestellten Daten basieren auf einem modellbasierten Bewertungsverfahren, das verschiedene Wetterparameter kombiniert. Trotz sorgfältiger Berechnung können Abweichungen auftreten, da lokale Bedingungen, Mikroklima oder kurzfristige Wetteränderungen variieren können. Die API liefert daher keine Garantie für absolute Richtigkeit, Vollständigkeit oder Aktualität der Daten.

Die Nutzung der bereitgestellten Daten erfolgt auf eigene Verantwortung. Entscheidungen zur Durchführung von Mäharbeiten oder anderen Maßnahmen sollten stets zusätzlich anhand der tatsächlichen örtlichen Bedingungen bewertet werden. Eine Haftung für direkte oder indirekte Schäden, die aus der Nutzung oder Nichtverfügbarkeit der API oder der bereitgestellten Daten entstehen, ist ausgeschlossen.

Es wird keine Gewähr für eine jederzeitige und unterbrechungsfreie Verfügbarkeit der API übernommen. Wartungsarbeiten, technische Störungen oder Anpassungen der Schnittstelle können jederzeit zu Einschränkungen oder temporären Ausfällen führen.

Nutzung

Darf ich die API-Daten öffentlich anzeigen?

Öffentliche Darstellung der API-Daten

Ja. Die Daten der Mähbarkeitsindex API dürfen grundsätzlich öffentlich angezeigt und in Anwendungen integriert werden, beispielsweise auf Websites, in Apps oder in Dashboards. Die öffentliche Darstellung des Mähbarkeitsindex ist ausdrücklich erwünscht, da sie Nutzern hilft, die aktuellen Mähbedingungen besser einzuschätzen.

Pflicht zur Quellenangabe

Wenn Daten aus der Mähbarkeitsindex API öffentlich angezeigt werden, muss an der Ausgabestelle ein sichtbarer Verweis auf die Quelle gesetzt werden. Die Quellenangabe muss direkt in der Nähe der Anzeige erfolgen und auf folgende Website verlinken: https://www.maehbarkeitsindex.de

Dies stellt sicher, dass die Herkunft des Index nachvollziehbar bleibt und Nutzer zusätzliche Informationen zum Modell und zur Berechnung finden können.

Beispiel für eine Quellenangabe (Website)

Ein typisches Beispiel für die Darstellung auf einer Website: 

 Quelle: Mähbarkeitsindex (MFI)

Beispiel für Apps oder Widgets

In mobilen Apps oder Widgets sollte die Quellenangabe ebenfalls sichtbar sein, beispielsweise im Footer oder unterhalb der Anzeige: 

Quelle: maehbarkeitsindex.de

Verwendung in Grafiken oder Dashboards

Wenn der Mähbarkeitsindex in Diagrammen, Karten oder Dashboards verwendet wird, sollte die Quellenangabe im jeweiligen Element integriert werden. 

Mähbarkeitsindex | Quelle: maehbarkeitsindex.de

Unzulässige Nutzung

Nicht erlaubt ist insbesondere:

  • Entfernen oder Verschleiern der Quelle
  • Weiterverkauf der API-Daten als eigene Datenquelle
  • massenhafte Weiterverteilung ohne Bezug zur ursprünglichen Quelle
  • Nutzung unter einem anderen Namen ohne Hinweis auf den Mähbarkeitsindex

Ziel der Quellenangabe

Die verpflichtende Quellenangabe erfüllt mehrere Funktionen:

  • Transparenz über die Herkunft der Daten
  • Verlinkung zur vollständigen Dokumentation des Mähbarkeitsindex
  • fachliche Einordnung des Index
  • Sicherstellung der korrekten Verwendung des Begriffs Mähbarkeitsindex (MFI)
FAQ

Häufige Fragen zum MFI API Regelwerk

Die Mähbarkeitsindex API ist eine Schnittstelle, über die Anwendungen automatisiert den aktuellen Mähbarkeitsindex abrufen können. Der Index bewertet anhand von Wetterdaten, ob Rasenflächen aktuell gemäht werden können.

API-Requests sind maximal einmal alle 5 Minuten erlaubt. Zusätzlich gilt ein Limit von 15 Requests pro Stunde und 360 Requests pro Tag.

Ja. Die Nutzung der Mähbarkeitsindex API ist nur mit einem persönlichen API-Key möglich. Dieser wird bei der Registrierung generiert und ist an eine E-Mail-Adresse gebunden.

Nein. Jeder API-Key darf ausschließlich für eine einzelne Anwendung verwendet werden.

Rate Limits verhindern Serverüberlastung und stellen sicher, dass alle Nutzer stabil auf die API zugreifen können. Außerdem ändern sich Mähbedingungen nicht innerhalb weniger Minuten.

Wenn die Limits überschritten werden, kann der API-Zugang temporär gesperrt werden. Wiederholte Verstöße können zur dauerhaften Deaktivierung führen.

Ja. Alle Requests müssen über HTTPS erfolgen. Unverschlüsselte HTTP-Verbindungen werden nicht akzeptiert.

Ja. Du kannst jederzeit die Löschung deines API-Keys beantragen. Dies ist über das Kontaktformular oder per E-Mail möglich.

Ja, solange der API-Key nicht öffentlich weitergegeben wird und die Rate Limits eingehalten werden.

Bei technischen Fragen oder Problemen kannst du dich per E-Mail an info@maehbarkeitsindex.de wenden.