Voor ontwikkelaars en organisaties
API voor ontwikkelaars en organisaties
Met de gratis API van Ik ben vermist toont een gemeente, politiezone, dierenarts, asiel of nieuwssite op haar eigen website of app welke huisdieren in de buurt vermist of gevonden zijn, met een link naar de melding op ikbenvermist.be. Elke sleutel wordt door ons persoonlijk goedgekeurd. Je krijgt alleen wat nodig is om te linken: het soort dier, de gemeente, de datum en de link.
- Gratis
- Zonder persoonsgegevens
- Alles leidt naar ikbenvermist.be
Waarom een API?
Hoe meer mensen een melding zien, hoe sneller een dier thuis is. Met de API zet je de meldingen uit je regio als links op je eigen site: een lijst "vermist in onze gemeente", een teller op je startpagina, een melding in je app. Wie klikt, komt op Ik ben vermist terecht, waar baasjes en vinders veilig contact leggen. Je toont geen foto's of beschrijvingen van meldingen op je eigen site: zo blijft alles actueel en verdwijnt een melding overal zodra ze afgesloten is.
Waarvoor organisaties de API gebruiken
-
Gemeentewebsites en -apps
Een blok "Vermist en gevonden in onze gemeente" met links naar de meldingen en naar de gemeentepagina op Ik ben vermist.
-
Politie en dierenartsen
In het eigen systeem of intranet zien welke dieren in de zone vermist zijn, met één klik naar de melding.
-
Software van asielen
Bij een binnengebracht dier nagaan of er in de buurt een melding is, en doorklikken naar Ik ben vermist.
-
Nieuwssites en lokale media
Bij een artikel over een gemeente de actuele meldingen uit die gemeente als links tonen.
-
Onderzoek en beleid
Geaggregeerde cijfers en de kwartaalbarometer, per provincie en diersoort, met bronvermelding.
Zo vraag je een sleutel aan
Vul het formulier in
Zeg wie je bent en waarvoor je de API wil gebruiken.
Bevestig je e-mailadres
Je krijgt een mail met een bevestigingslink.
Wij keuren goed
Een medewerker bekijkt elke aanvraag persoonlijk, meestal binnen enkele werkdagen.
Haal je sleutel op
Je krijgt een link die je sleutel één keer toont. Bewaar hem veilig.
Meldingen insturen via de API
Meldingen insturen via de API (bijvoorbeeld door dierenartsen of een overheid) is voorbereid maar nog niet beschikbaar. Ook dan komt een melding nooit meteen online: de melder bevestigt eerst per mail, daarna volgt onze gewone controle. Interesse? Laat het ons weten in je aanvraag.
Limieten en polling
Verzoeken per sleutel
- per minuut
- 60
- per uur
- 1.000
- per dag
- 10.000
Dat is de standaard. Meer nodig? Vraag het ons. info@ikbenvermist.be
Limiet bereikt of te druk?
429- Limiet bereikt. Wacht het aantal seconden uit
Retry-After. 503- Tijdelijk grote drukte. Wacht even en probeer dan opnieuw.
Zo blijf je up-to-date
-
Meldingen hooguit om de 15 minuten
Synchroniseer met
updated_sinceenIf-None-Match: ongewijzigd geeft een304zonder inhoud. -
Cijfers en gemeenten: één keer per dag volstaat
-
Hetzelfde verzoek komt uit de cache
Binnen 60 seconden (meldingen) of 1 uur (cijfers, barometer, gemeenten) krijg je het vorige antwoord.
-
Verwijderingen binnen 24 uur
Vraag minstens één keer per dag de lijst met verwijderde meldingen op en verwijder die binnen 24 uur bij jou.
Documentatie
De documentatie beschrijft elk endpoint met parameters en voorbeelden in curl, JavaScript en PHP, plus een verkenner waarin je de API meteen uitprobeert met voorbeelddata. Voor eigen tools is er een OpenAPI 3.1-bestand.
curl -s "https://ikbenvermist.be/wp-json/ibv/api/v1/listings?gemeente=hasselt" \
-H "Authorization: Bearer $IBV_API_KEY"Gebruiksvoorwaarden
Via onze API delen we nooit persoonsgegevens: geen namen, telefoonnummers, e-mailadressen, chipnummers, foto's, beschrijvingen of exacte adressen. Partnerorganisaties krijgen alleen het soort dier, de gemeente, de datum en een link naar de melding op Ik ben vermist. Contact verloopt altijd via onze site.
Gratis, na goedkeuring
De API is gratis. Elke sleutel wordt persoonlijk goedgekeurd en is 12 maanden geldig; je kan hem met één klik verlengen.
Altijd een link naar Ik ben vermist
Toon bij elke melding de link uit het veld url, ongewijzigd, met de vermelding "via Ik ben vermist". Contact tussen baasjes, vinders en anderen verloopt altijd via onze site.
Geen meldingen of foto's overnemen
Je publiceert geen meldingen, foto's, beschrijvingen of andere inhoud van Ik ben vermist op je eigen kanalen. Je toont alleen de gegevens uit de API, als verwijzing naar onze site.
Geen verkoop, geen koppeling met persoonsgegevens
Je verkoopt of verhuurt de gegevens niet en geeft ze niet door. Je combineert ze niet met persoonsgegevens en probeert niet te achterhalen wie een melding plaatste.
Verwijderingen binnen 24 uur
Vraag minstens één keer per dag de lijst met verwijderde meldingen op en verwijder die binnen 24 uur bij jou. Hetzelfde geldt voor alles wat je ophaalde als je sleutel verloopt of ingetrokken wordt.
Limieten respecteren
Houd je aan de limieten en de pollingregels hierboven. Gebruik If-None-Match en updated_since in plaats van alles opnieuw op te vragen.
Sleutel geheim houden
Je sleutel hoort alleen in de Authorization- of X-API-Key-header vanaf je eigen server: nooit in een URL, in code die in de browser draait of in een openbare repository. Vermoed je een lek? Meld het meteen, dan maken we een nieuwe.
Wij mogen intrekken
We kunnen een sleutel op elk moment pauzeren of intrekken, bijvoorbeeld bij misbruik, als de voorwaarden niet gevolgd worden of als je hem 90 dagen niet gebruikt. We kunnen de API aanpassen; grote wijzigingen kondigen we vooraf aan.
Geen garantie
We doen ons best om de API beschikbaar en correct te houden, maar geven geen garantie op beschikbaarheid of volledigheid.
Contact
Vragen, een hogere limiet of een probleem melden? Mail naar info@ikbenvermist.be.
Veelgestelde vragen
Wat kost de API?
Niets. De API is gratis voor organisaties, ontwikkelaars, media en onderzoekers. Elke sleutel wordt wel persoonlijk goedgekeurd.
Welke gegevens krijg ik?
Per melding het nummer, de status (vermist, gevonden, gezien of terug thuis), het soort dier, de gemeente en provincie, de datum en een vaste link naar de melding op ikbenvermist.be. Daarnaast cijfers, de barometer en de lijst met gemeenten. Nooit persoonsgegevens, foto's of beschrijvingen.
Waarom krijg ik geen foto's of beschrijvingen?
Omdat ze bij de baasjes en vinders horen en snel kunnen wijzigen of verdwijnen. Door altijd naar onze site te linken, ziet iedereen de actuele melding en verdwijnt ze overal zodra ze afgesloten is. Contact loopt via ons beveiligd formulier, zodat niemand zijn e-mailadres hoeft te delen.
Kunnen baasjes kiezen of hun melding gedeeld wordt?
Ja. Wie een melding plaatst, kan aanvinken dat ze niet via de API gedeeld wordt, en dat later nog wijzigen. Zo'n melding verschijnt dan niet in de API en staat in de lijst met verwijderde meldingen.
Hoe snel krijg ik een sleutel?
Meestal binnen enkele werkdagen. Na goedkeuring krijg je een link die je sleutel één keer toont.
Kan ik de API in de browser gebruiken?
Nee, de sleutel hoort op je eigen server. Je server haalt de gegevens op en je website toont de links. Zo blijft je sleutel geheim.
Kan ik ook meldingen insturen?
Nog niet. Die mogelijkheid is voorbereid, bijvoorbeeld voor dierenartsen of een overheid. Laat het ons weten als je interesse hebt.