{"openapi":"3.1.0","info":{"title":"Wetterstation Hohenkammer – öffentliche API","version":"1.0.0","description":"Öffentliche Wetterwerte ohne Anmeldung. Pro IP sind 10 Anfragen innerhalb von rollierenden 60 Sekunden (1 Minute) erlaubt. Die 11. Anfrage sperrt die IP für 15 Minuten und liefert HTTP 429. Weitere Anfragen verlängern die Sperre nicht. Retry-After nennt die verbleibende Sperrzeit in Sekunden. GET, HEAD, abgewiesene Methoden und Wetterfehler zählen. OPTIONS, die Dokumentation und die Spezifikation zählen nicht. Fehlende und veraltete Messwerte entfallen.\n\nDiese Wetterstation wird als privates Hobbyprojekt betrieben. Die Angaben dienen der allgemeinen Information. Für ihre Richtigkeit, Vollständigkeit und Aktualität wird keine Gewähr übernommen.\n\nDas Angebot wird freiwillig und ohne Zusage einer dauerhaften oder unterbrechungsfreien Verfügbarkeit bereitgestellt. Inhalte und Schnittstellen können jederzeit geändert, eingeschränkt oder eingestellt werden.\n\nDie eigenen Messdaten dürfen ausschließlich privat und nicht kommerziell genutzt werden. Eine kommerzielle Nutzung, Weiterverwertung oder ein Weiterverkauf dieser Daten ist nicht gestattet.","termsOfService":"/api/docs#disclaimer"},"servers":[{"url":"/","description":"Derselbe Host wie diese Spezifikation"}],"externalDocs":{"url":"/api/docs","description":"API-Dokumentation"},"security":[],"tags":[{"name":"Wetter","description":"Aktuelle lokale Wetterwerte"}],"paths":{"/api/weather":{"x-rate-limit":{"scope":"ip","requests":10,"windowSeconds":60,"banSeconds":900,"strategy":"sliding-window"},"get":{"operationId":"getCurrentWeather","tags":["Wetter"],"summary":"Aktuelle Wetterdaten abrufen","description":"Pro IP sind 10 Anfragen innerhalb von rollierenden 60 Sekunden (1 Minute) erlaubt. Die 11. Anfrage sperrt die IP für 15 Minuten und liefert HTTP 429. Weitere Anfragen verlängern die Sperre nicht. Retry-After nennt die verbleibende Sperrzeit in Sekunden.","responses":{"200":{"description":"Frische Wetterdaten; fehlende Werte entfallen.","headers":{"Cache-Control":{"description":"Antworten werden nicht zwischengespeichert.","schema":{"type":"string","const":"no-store"}},"Access-Control-Allow-Origin":{"description":"Öffentlich lesbar ohne Credentials.","schema":{"type":"string","const":"*"}},"X-RateLimit-Limit":{"description":"Maximale Anfragen pro IP im rollierenden Zeitfenster.","schema":{"type":"integer","const":10}},"X-RateLimit-Remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster; bei Sperre 0.","schema":{"type":"integer","minimum":0,"maximum":10}},"X-RateLimit-Reset":{"description":"Unix-Zeit in Sekunden, zu der die älteste gezählte Anfrage verfällt; bei Sperre deren Ablaufzeit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicWeather"},"example":{"last_update":"19:50","date":"22 Juni 2025","current_weather":"Dry","temperature":30.5,"max_temperature":{"value":34.9,"time":"17:50"},"min_temperature":{"value":9.1,"time":"04:25"},"wind":{"speed":1.9,"direction":"W (270°)","gusts":3,"max_speed_today":8,"max_speed_today_time":"15:20"},"rain":{"last_hour":0,"since_midnight":0,"last_24_hours":0},"atmosphere":{"humidity":47,"pressure":1018.3,"brightness":45000}}}}},"429":{"description":"IP gesperrt. Pro IP sind 10 Anfragen innerhalb von rollierenden 60 Sekunden (1 Minute) erlaubt. Die 11. Anfrage sperrt die IP für 15 Minuten und liefert HTTP 429. Weitere Anfragen verlängern die Sperre nicht. Retry-After nennt die verbleibende Sperrzeit in Sekunden.","headers":{"Cache-Control":{"description":"Antworten werden nicht zwischengespeichert.","schema":{"type":"string","const":"no-store"}},"Access-Control-Allow-Origin":{"description":"Öffentlich lesbar ohne Credentials.","schema":{"type":"string","const":"*"}},"X-RateLimit-Limit":{"description":"Maximale Anfragen pro IP im rollierenden Zeitfenster.","schema":{"type":"integer","const":10}},"X-RateLimit-Remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster; bei Sperre 0.","schema":{"type":"integer","minimum":0,"maximum":10}},"X-RateLimit-Reset":{"description":"Unix-Zeit in Sekunden, zu der die älteste gezählte Anfrage verfällt; bei Sperre deren Ablaufzeit.","schema":{"type":"integer"}},"Retry-After":{"description":"Verbleibende Sperrzeit in Sekunden. Erst danach erneut anfragen.","schema":{"type":"integer","minimum":1},"example":900}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":"IP_BANNED"}}}},"503":{"description":"Vorübergehend nicht verfügbar: WEATHER_UNAVAILABLE (Wetterdaten nicht verfügbar), NO_FRESH_DATA (keine aktuellen Messungen), CLIENT_IP_UNAVAILABLE (IP-Adresse nicht verfügbar) oder RATE_LIMIT_UNAVAILABLE (Anfragelimit derzeit nicht prüfbar). Rate-Limit-Header sind nur nach erfolgreicher Limitprüfung vorhanden.","headers":{"Cache-Control":{"description":"Antworten werden nicht zwischengespeichert.","schema":{"type":"string","const":"no-store"}},"Access-Control-Allow-Origin":{"description":"Öffentlich lesbar ohne Credentials.","schema":{"type":"string","const":"*"}},"X-RateLimit-Limit":{"description":"Maximale Anfragen pro IP im rollierenden Zeitfenster.","schema":{"type":"integer","const":10}},"X-RateLimit-Remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster; bei Sperre 0.","schema":{"type":"integer","minimum":0,"maximum":10}},"X-RateLimit-Reset":{"description":"Unix-Zeit in Sekunden, zu der die älteste gezählte Anfrage verfällt; bei Sperre deren Ablaufzeit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"head":{"operationId":"headCurrentWeather","tags":["Wetter"],"summary":"Verfügbarkeit und Rate-Limit-Header prüfen","description":"Zählt wie GET. Pro IP sind 10 Anfragen innerhalb von rollierenden 60 Sekunden (1 Minute) erlaubt. Die 11. Anfrage sperrt die IP für 15 Minuten und liefert HTTP 429. Weitere Anfragen verlängern die Sperre nicht. Retry-After nennt die verbleibende Sperrzeit in Sekunden. Die Antwort enthält keinen Body.","responses":{"200":{"description":"Frische Wetterdaten; fehlende Werte entfallen.","headers":{"Cache-Control":{"description":"Antworten werden nicht zwischengespeichert.","schema":{"type":"string","const":"no-store"}},"Access-Control-Allow-Origin":{"description":"Öffentlich lesbar ohne Credentials.","schema":{"type":"string","const":"*"}},"X-RateLimit-Limit":{"description":"Maximale Anfragen pro IP im rollierenden Zeitfenster.","schema":{"type":"integer","const":10}},"X-RateLimit-Remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster; bei Sperre 0.","schema":{"type":"integer","minimum":0,"maximum":10}},"X-RateLimit-Reset":{"description":"Unix-Zeit in Sekunden, zu der die älteste gezählte Anfrage verfällt; bei Sperre deren Ablaufzeit.","schema":{"type":"integer"}}}},"429":{"description":"IP gesperrt. Pro IP sind 10 Anfragen innerhalb von rollierenden 60 Sekunden (1 Minute) erlaubt. Die 11. Anfrage sperrt die IP für 15 Minuten und liefert HTTP 429. Weitere Anfragen verlängern die Sperre nicht. Retry-After nennt die verbleibende Sperrzeit in Sekunden.","headers":{"Cache-Control":{"description":"Antworten werden nicht zwischengespeichert.","schema":{"type":"string","const":"no-store"}},"Access-Control-Allow-Origin":{"description":"Öffentlich lesbar ohne Credentials.","schema":{"type":"string","const":"*"}},"X-RateLimit-Limit":{"description":"Maximale Anfragen pro IP im rollierenden Zeitfenster.","schema":{"type":"integer","const":10}},"X-RateLimit-Remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster; bei Sperre 0.","schema":{"type":"integer","minimum":0,"maximum":10}},"X-RateLimit-Reset":{"description":"Unix-Zeit in Sekunden, zu der die älteste gezählte Anfrage verfällt; bei Sperre deren Ablaufzeit.","schema":{"type":"integer"}},"Retry-After":{"description":"Verbleibende Sperrzeit in Sekunden. Erst danach erneut anfragen.","schema":{"type":"integer","minimum":1},"example":900}}},"503":{"description":"Vorübergehend nicht verfügbar: WEATHER_UNAVAILABLE (Wetterdaten nicht verfügbar), NO_FRESH_DATA (keine aktuellen Messungen), CLIENT_IP_UNAVAILABLE (IP-Adresse nicht verfügbar) oder RATE_LIMIT_UNAVAILABLE (Anfragelimit derzeit nicht prüfbar). Rate-Limit-Header sind nur nach erfolgreicher Limitprüfung vorhanden.","headers":{"Cache-Control":{"description":"Antworten werden nicht zwischengespeichert.","schema":{"type":"string","const":"no-store"}},"Access-Control-Allow-Origin":{"description":"Öffentlich lesbar ohne Credentials.","schema":{"type":"string","const":"*"}},"X-RateLimit-Limit":{"description":"Maximale Anfragen pro IP im rollierenden Zeitfenster.","schema":{"type":"integer","const":10}},"X-RateLimit-Remaining":{"description":"Verbleibende Anfragen im aktuellen Zeitfenster; bei Sperre 0.","schema":{"type":"integer","minimum":0,"maximum":10}},"X-RateLimit-Reset":{"description":"Unix-Zeit in Sekunden, zu der die älteste gezählte Anfrage verfällt; bei Sperre deren Ablaufzeit.","schema":{"type":"integer"}}}}}},"options":{"operationId":"weatherPreflight","tags":["Wetter"],"summary":"CORS-Preflight ohne Verbrauch des Anfragebudgets","responses":{"204":{"description":"CORS erlaubt GET, HEAD und OPTIONS ohne Anmeldung.","headers":{"Cache-Control":{"description":"Antworten werden nicht zwischengespeichert.","schema":{"type":"string","const":"no-store"}},"Access-Control-Allow-Origin":{"description":"Öffentlich lesbar ohne Credentials.","schema":{"type":"string","const":"*"}},"Access-Control-Allow-Methods":{"schema":{"type":"string","const":"GET, HEAD, OPTIONS"}},"Access-Control-Max-Age":{"schema":{"type":"integer","const":600}}}}}}}},"components":{"schemas":{"PublicWeather":{"type":"object","required":["last_update","date"],"additionalProperties":false,"description":"Aktuelle lokale Wetterwerte. Fehlende oder veraltete Felder und leere Gruppen entfallen. Alle Uhrzeiten gelten in Europe/Berlin.","properties":{"last_update":{"type":"string","pattern":"^\\d{2}:\\d{2}$","examples":["19:50"],"description":"Zeitpunkt der neuesten enthaltenen Messung, HH:mm."},"date":{"type":"string","description":"Datum dieser Messung in Europe/Berlin, z. B. 22 Juni 2025."},"current_weather":{"type":"string","enum":["Dry","Rain"],"description":"Aktueller Zustand: trocken oder Regen."},"temperature":{"type":"number","description":"Aktuelle Außentemperatur in °C."},"max_temperature":{"type":"object","required":["value"],"additionalProperties":false,"properties":{"value":{"type":"number","description":"Temperatur in °C."},"time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","examples":["19:50"],"description":"Ereigniszeit in Europe/Berlin; entfällt ohne verfügbaren Zeitpunkt."}},"description":"Höchste Temperatur des aktuellen Tages."},"min_temperature":{"type":"object","required":["value"],"additionalProperties":false,"properties":{"value":{"type":"number","description":"Temperatur in °C."},"time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","examples":["19:50"],"description":"Ereigniszeit in Europe/Berlin; entfällt ohne verfügbaren Zeitpunkt."}},"description":"Niedrigste Temperatur des aktuellen Tages."},"wind":{"type":"object","additionalProperties":false,"description":"Windmessungen ohne zugesichertes 10-Minuten- oder Stundenintervall.","properties":{"speed":{"type":"number","description":"Aktuelle Windgeschwindigkeit in km/h."},"direction":{"type":"string","description":"Windrichtung mit Himmelsrichtung und Grad, z. B. W (270°)."},"gusts":{"type":"number","description":"Aktueller Böenwert in km/h; kein Stundenmaximum."},"max_speed_today":{"type":"number","description":"Höchste Windgeschwindigkeit des Tages in km/h."},"max_speed_today_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","examples":["19:50"],"description":"Ereigniszeit des Tageswindmaximums in Europe/Berlin."}}},"rain":{"type":"object","additionalProperties":false,"description":"Regenmengen in mm mit getrennten Bezugszeiträumen.","properties":{"last_hour":{"type":"number","description":"Regenmenge der letzten Stunde in mm."},"since_midnight":{"type":"number","description":"Regenmenge seit Mitternacht in mm."},"last_24_hours":{"type":"number","description":"Rollierende Regenmenge der letzten 24 Stunden in mm."}}},"atmosphere":{"type":"object","additionalProperties":false,"description":"Luftfeuchtigkeit, Luftdruck und Helligkeit.","properties":{"humidity":{"type":"number","description":"Relative Luftfeuchtigkeit in %."},"pressure":{"type":"number","description":"Luftdruck in hPa."},"brightness":{"type":"number","description":"Helligkeitswert ohne festgelegte Einheit."}}}}},"ApiError":{"type":"object","required":["error"],"additionalProperties":false,"properties":{"error":{"type":"string","enum":["IP_BANNED","WEATHER_UNAVAILABLE","NO_FRESH_DATA","CLIENT_IP_UNAVAILABLE","RATE_LIMIT_UNAVAILABLE","METHOD_NOT_ALLOWED"]}}}}}}