GET · JSON · ohne Anmeldung
Community-Gefahrenmeldungen
Kurzlebige, nicht unabhängig geprüfte Hinweise auf Wildtiere, tote Tiere, mögliche Köder oder Gift, Scherben, vermutete Blaualgen, sonstige Gefahren und klar gekennzeichnete Tests. Die meldende Person wird niemals ausgegeben.
GET https://ruffolio.com/api/v1/danger-reports?latitude=52.52&longitude=13.405&radius_m=1500&schema_version=2
latitude / longitude- Mittelpunkt der Umgebungssuche.
radius_m- Ganzer Wert von 1 bis 10.000 Metern.
schema_version=2- Liefert alle aktuellen Kategorien einschließlich
blue_green_algae und die optionale Gewässerbezeichnung. Ohne Angabe gilt aus Kompatibilitätsgründen Version 1.
Die Antwort enthält schema_version und bis zu 250 aktive items mit ID, Kategorie, optionaler Notiz und Gewässerbezeichnung, exaktem markiertem Ort sowie Erstellungs- und Ablaufzeitpunkt – ohne Konto-, Profil- oder Spitznamendaten.
GET · JSON · ohne Anmeldung
Kuratierte Gewässerwarnungen
Aktuelle und historische Hinweise zu Blaualgen sowie aktuelle, quellenbelegte Grün- oder Fadenalgenmeldungen an BfG-verifizierten Flüssen und Seen. BfG bestätigt dabei die Gewässeridentität, nicht den Warninhalt; „kuratiert“ bedeutet nicht „amtlich“.
GET https://ruffolio.com/api/v1/water-warnings?latitude=52.52&longitude=13.405&radius_m=10000&schema_version=2
latitude / longitude- Mittelpunkt der Umgebungssuche.
radius_m- Ganzer Wert von 1 bis 25.000 Metern.
schema_version=2- Ergänzt
reported_green_algae für gemeldete Grün- oder Fadenalgen. Das ist keine Aussage über Cyanobakterien, Giftigkeit oder ein Badeverbot. Ohne Angabe gilt aus Kompatibilitätsgründen Version 1.
Bis zu 250 Ergebnisse enthalten Warnart, Gewässername und stabilen source_id, Quellenhinweis, Warnpunkt und radius_m, optionale Notiz und Belegquelle sowie Beginn, Erstellung und Ablauf. Es gibt keine Seitennavigation; wähle bei Bedarf einen kleineren Radius. Der Warnkreis gilt, nicht automatisch das gesamte benannte Gewässer.
GET · JSON · ohne Anmeldung
Geplante Feuerwerke
Kuratierte, zeitlich begrenzte Termine mit öffentlicher HTTPS-Quelle. Das aus Kompatibilitätsgründen estimated_audibility_radius_m genannte Feld ist ein redaktioneller Auswahlradius für Hinweise, keine Schallprognose oder Garantie, dass ein Feuerwerk tatsächlich stattfindet oder hörbar ist.
GET https://ruffolio.com/api/v1/fireworks
- Keine Standortparameter
- Alle Geräte laden dasselbe deutschlandweite Paket für höchstens 48 Stunden. Der Abgleich mit dem aktuellen Standort kann vollständig auf dem Gerät erfolgen; der Endpunkt akzeptiert keine Query-Parameter.
- Antwortumschlag
schema_version: 1, generated_at, stale_after und horizon_ends_at beschreiben Version, Erzeugung, empfohlenen nächsten Abruf und das Ende des Pakethorizonts.
Jeder Eintrag enthält eine stabile external_id und serverseitige revision, country_code: "DE", Titel, Veranstaltungsort und Ort, Punkt, estimated_audibility_radius_m mit radius_basis, Hinweis-, Start- und Endzeit, eine optionale Notiz sowie die verpflichtende Belegquelle. Entferne einen Eintrag bei ends_at. Ersetze eine ältere Revision derselben external_id durch die aktuelle und formuliere Hörbarkeit immer als Möglichkeit.
Datensparsam abfragen
Frage nur den Umkreis ab, den deine Funktion wirklich benötigt. Sende keine Route, Konto- oder Hunde-ID. Standortabfragen erreichen Ruffolio/Vercel. Community-Antworten enthalten den exakten Gefahrenort, aber keine Angaben zur meldenden Person.
Quellen sichtbar lassen
Zeige bei Gewässerwarnungen water_body.source_attribution unverändert an. Zeige bei Feuerwerken immer source.label und verlinke source.url; bei anderen Hinweisen gilt das, sobald eine Belegquelle vorhanden ist. Kennzeichne Community-Meldungen als ungeprüfte Hinweise aus der Ruffolio Community.
Sicher integrieren
Fordere für Umkreisabfragen Version 2 ausdrücklich an, prüfe die Antwortversion und frage ein Gebiet höchstens alle 30 Sekunden neu ab. Ersetze einen gespeicherten Gebietssnapshot nur nach HTTP 200 und entferne dort Einträge bei expires_at. Beim Feuerwerk-Endpunkt ersetzt du den gespeicherten Snapshot ebenfalls nur nach HTTP 200, rufst ihn spätestens nach stale_after erneut ab und entfernst Einträge bei ends_at. Die APIs sind kein dauerhaftes Archiv. Korrigiere HTTP 400; versuche es bei HTTP 429 oder 503 mit wachsendem Abstand erneut. Fehler stehen unter error.code und error.message; die x-request-id hilft bei Rückfragen.
Eine leere Antwort ist kein „Alles frei“-Signal. Ruffolio bestätigt Community-Meldungen nicht unabhängig. Feuerwerkstermine können sich kurzfristig ändern oder ausfallen; weder Hörbarkeit noch Benachrichtigungszustellung sind garantiert. Beachte Schilder, Badeverbote und Hinweise zuständiger Stellen; die API ersetzt weder Polizei, Feuerwehr, Rettungsdienst, Veterinäramt noch tierärztliche Beratung.
Ruffolio