Für Entwickler und Organisationen
API für Entwickler und Organisationen
Mit der kostenlosen API von Ik ben vermist zeigt eine Gemeinde, Polizeizone, Tierarztpraxis, ein Tierheim oder eine Nachrichtenseite auf der eigenen Website oder App, welche Haustiere in der Umgebung vermisst oder gefunden wurden, mit einem Link zur Meldung auf ikbenvermist.be. Jeden Schlüssel genehmigen wir persönlich. Sie erhalten nur, was zum Verlinken nötig ist: die Tierart, die Gemeinde, das Datum und den Link.
- Kostenlos
- Ohne personenbezogene Daten
- Alles führt zu ikbenvermist.be
Warum eine API?
Je mehr Menschen eine Meldung sehen, desto schneller ist ein Tier wieder zu Hause. Mit der API stellen Sie die Meldungen aus Ihrer Region als Links auf Ihre eigene Website: eine Liste „vermisst in unserer Gemeinde“, einen Zähler auf Ihrer Startseite, eine Benachrichtigung in Ihrer App. Wer klickt, landet bei Ik ben vermist, wo Besitzer und Finder sicher Kontakt aufnehmen. Sie zeigen keine Fotos oder Beschreibungen von Meldungen auf Ihrer Website: So bleibt alles aktuell, und eine Meldung verschwindet überall, sobald sie abgeschlossen ist.
Wofür Organisationen die API nutzen
-
Websites und Apps von Gemeinden
Ein Block „Vermisst und gefunden in unserer Gemeinde“ mit Links zu den Meldungen und zur Gemeindeseite auf Ik ben vermist.
-
Polizei und Tierärzte
Im eigenen System oder Intranet sehen, welche Tiere in der Zone vermisst werden, und die Meldung mit einem Klick öffnen.
-
Software von Tierheimen
Bei einem abgegebenen Tier prüfen, ob es in der Nähe eine Meldung gibt, und zu Ik ben vermist weiterklicken.
-
Nachrichtenseiten und lokale Medien
Neben einem Artikel über eine Gemeinde die aktuellen Meldungen dieser Gemeinde als Links zeigen.
-
Forschung und Politik
Aggregierte Zahlen und das Quartalsbarometer, nach Provinz und Tierart, mit Quellenangabe.
So fragen Sie einen Schlüssel an
Füllen Sie das Formular aus
Sagen Sie uns, wer Sie sind und wofür Sie die API nutzen möchten.
Bestätigen Sie Ihre E-Mail-Adresse
Sie erhalten eine E-Mail mit einem Bestätigungslink.
Wir genehmigen
Ein Teammitglied prüft jede Anfrage persönlich, meist innerhalb weniger Werktage.
Rufen Sie Ihren Schlüssel ab
Sie erhalten einen Link, der Ihren Schlüssel einmal anzeigt. Bewahren Sie ihn sicher auf.
Meldungen über die API einsenden
Das Einsenden von Meldungen über die API (zum Beispiel durch Tierärzte oder eine Behörde) ist vorbereitet, aber noch nicht verfügbar. Auch dann geht eine Meldung nie direkt online: Die meldende Person bestätigt zuerst per E-Mail, danach folgt unsere übliche Prüfung. Interesse? Erwähnen Sie es in Ihrer Anfrage.
Limits und Polling
Anfragen pro Schlüssel
- pro Minute
- 60
- pro Stunde
- 1.000
- pro Tag
- 10.000
Das sind die Standardwerte. Sie brauchen mehr? Fragen Sie uns. info@ikbenvermist.be
Limit erreicht oder starker Andrang?
429- Limit erreicht. Warten Sie die Anzahl Sekunden aus
Retry-After. 503- Vorübergehend starker Andrang. Warten Sie kurz und versuchen Sie es dann erneut.
So bleiben Sie aktuell
-
Meldungen höchstens alle 15 Minuten
Synchronisieren Sie mit
updated_sinceundIf-None-Match: Unverändert ergibt ein304ohne Inhalt. -
Zahlen und Gemeinden: einmal täglich genügt
-
Dieselbe Anfrage kommt aus dem Cache
Innerhalb von 60 Sekunden (Meldungen) oder 1 Stunde (Zahlen, Barometer, Gemeinden) erhalten Sie die vorige Antwort.
-
Löschungen innerhalb von 24 Stunden
Rufen Sie mindestens einmal täglich die Liste der entfernten Meldungen ab und entfernen Sie diese bei sich innerhalb von 24 Stunden.
Dokumentation
Die Dokumentation beschreibt jeden Endpunkt mit Parametern und Beispielen in curl, JavaScript und PHP, dazu einen Explorer, in dem Sie die API sofort mit Beispieldaten ausprobieren. Für eigene Tools gibt es eine OpenAPI-3.1-Datei.
curl -s "https://ikbenvermist.be/wp-json/ibv/api/v1/listings?gemeente=hasselt" \
-H "Authorization: Bearer $IBV_API_KEY"Nutzungsbedingungen
Über unsere API teilen wir nie personenbezogene Daten: keine Namen, Telefonnummern, E-Mail-Adressen, Chipnummern, Fotos, Beschreibungen oder genauen Adressen. Partnerorganisationen erhalten nur die Tierart, die Gemeinde, das Datum und einen Link zur Meldung auf Ik ben vermist. Der Kontakt läuft immer über unsere Website.
Kostenlos, nach Genehmigung
Die API ist kostenlos. Jeder Schlüssel wird persönlich genehmigt und ist 12 Monate gültig; Sie können ihn mit einem Klick verlängern.
Immer ein Link zu Ik ben vermist
Zeigen Sie bei jeder Meldung den Link aus dem Feld url, unverändert, mit dem Hinweis „via Ik ben vermist“. Der Kontakt zwischen Besitzern, Findern und anderen läuft immer über unsere Website.
Keine Übernahme von Meldungen oder Fotos
Sie veröffentlichen keine Meldungen, Fotos, Beschreibungen oder anderen Inhalte von Ik ben vermist auf Ihren eigenen Kanälen. Sie zeigen nur die Daten aus der API, als Verweis auf unsere Website.
Kein Verkauf, keine Verknüpfung mit personenbezogenen Daten
Sie verkaufen oder vermieten die Daten nicht und geben sie nicht weiter. Sie verknüpfen sie nicht mit personenbezogenen Daten und versuchen nicht herauszufinden, wer eine Meldung aufgegeben hat.
Löschungen innerhalb von 24 Stunden
Rufen Sie mindestens einmal täglich die Liste der entfernten Meldungen ab und entfernen Sie diese bei sich innerhalb von 24 Stunden. Dasselbe gilt für alles, was Sie abgerufen haben, wenn Ihr Schlüssel abläuft oder widerrufen wird.
Limits einhalten
Halten Sie sich an die Limits und Polling-Regeln oben. Verwenden Sie If-None-Match und updated_since, statt alles erneut abzufragen.
Schlüssel geheim halten
Ihr Schlüssel gehört nur in den Authorization- oder X-API-Key-Header von Ihrem eigenen Server: nie in eine URL, in Code, der im Browser läuft, oder in ein öffentliches Repository. Vermuten Sie ein Leck? Melden Sie es sofort, dann erstellen wir einen neuen.
Wir dürfen widerrufen
Wir können einen Schlüssel jederzeit pausieren oder widerrufen, zum Beispiel bei Missbrauch, wenn die Bedingungen nicht eingehalten werden oder wenn Sie ihn 90 Tage nicht nutzen. Wir können die API ändern; größere Änderungen kündigen wir vorher an.
Keine Gewähr
Wir tun unser Bestes, damit die API verfügbar und korrekt bleibt, übernehmen aber keine Gewähr für Verfügbarkeit oder Vollständigkeit.
Kontakt
Fragen, ein höheres Limit oder ein Problem melden? Schreiben Sie an info@ikbenvermist.be.
Häufige Fragen
Was kostet die API?
Nichts. Die API ist kostenlos für Organisationen, Entwickler, Medien und Forschende. Jeder Schlüssel wird aber persönlich genehmigt.
Welche Daten erhalte ich?
Pro Meldung die Nummer, den Status (vermisst, gefunden, gesichtet oder wieder zu Hause), die Tierart, die Gemeinde und Provinz, das Datum und einen dauerhaften Link zur Meldung auf ikbenvermist.be. Dazu Zahlen, das Barometer und die Liste der Gemeinden. Nie personenbezogene Daten, Fotos oder Beschreibungen.
Warum keine Fotos oder Beschreibungen?
Weil sie den Besitzern und Findern gehören und sich schnell ändern oder verschwinden können. Da immer auf unsere Website verlinkt wird, sieht jeder die aktuelle Meldung, und sie verschwindet überall, sobald sie abgeschlossen ist. Der Kontakt läuft über unser sicheres Formular, sodass niemand seine E-Mail-Adresse teilen muss.
Können Besitzer wählen, ob ihre Meldung geteilt wird?
Ja. Beim Aufgeben einer Meldung kann man ankreuzen, dass sie nicht über die API geteilt wird, und das später noch ändern. Eine solche Meldung erscheint dann nicht in der API und steht in der Liste der entfernten Meldungen.
Wie schnell erhalte ich einen Schlüssel?
Meist innerhalb weniger Werktage. Nach der Genehmigung erhalten Sie einen Link, der Ihren Schlüssel einmal anzeigt.
Kann ich die API im Browser nutzen?
Nein, der Schlüssel gehört auf Ihren eigenen Server. Ihr Server ruft die Daten ab, und Ihre Website zeigt die Links. So bleibt Ihr Schlüssel geheim.
Kann ich auch Meldungen einsenden?
Noch nicht. Diese Möglichkeit ist vorbereitet, zum Beispiel für Tierärzte oder eine Behörde. Sagen Sie uns Bescheid, wenn Sie Interesse haben.