Öffentliche Sicherheits-API

Weil Hundeleben und Gesundheit zählen.

Gefahren enden nicht an App-Grenzen. Deshalb stellt Ruffolio aktive Community-Gefahrenmeldungen und kuratierte Gewässerwarnungen öffentlich als JSON bereit. Andere Apps, Karten und Dienste können sie ohne Anmeldung abrufen und Menschen mit Hund rechtzeitig informieren. Der öffentliche Zugriff ist lesend; neue Meldungen entstehen weiterhin über die geschützten Ruffolio-Abläufe.

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.

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. Ist eine Belegquelle vorhanden, zeige source.label und verlinke source.url. Kennzeichne Community-Meldungen als ungeprüfte Hinweise aus der Ruffolio Community.

Sicher integrieren

Fordere Version 2 ausdrücklich an und prüfe die zurückgegebene Version. Frage ein Gebiet höchstens alle 30 Sekunden neu ab. Ersetze einen gespeicherten Gebietssnapshot nur nach HTTP 200 und entferne Einträge spätestens bei expires_at; die API ist 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. Beachte Schilder, Badeverbote und Hinweise zuständiger Stellen; die API ersetzt weder Polizei, Feuerwehr, Rettungsdienst, Veterinäramt noch tierärztliche Beratung.