De afgelopen jaren is het terugmelden op de Basisregistraties Grootschalige Topografie (BGT), Topografie (BRT) en Adressen en Gebouwen (BAG) veel eenvoudiger geworden door de terugmeldmogelijkheden in Verbeter de Kaart en de BAG viewer. Vanaf 2019 wordt het ook mogelijk om vanuit andere systemen onjuistheden door te geven door middel van de ‘Terugmelding API’.
De terugmelding API is nu beschikbaar in de acceptatie-omgeving voor testdoeleinden. Via de API wordt het mogelijk om direct een terugmelding te doen op de BGT, BRT, BAG en KLIC (bèta). Ook is het mogelijk om terugmeldingen te bekijken door deze op te halen. Uiteraard zullen meldingen in de acceptatie-omgeving niet daadwerkelijk doorgestuurd worden naar de bronhouder. De acceptatieomgeving van de API is beschikbaar via de volgende URL:
https://api.acceptatie.kadaster.nl/tms/v1/terugmeldingen
De API is beveiligd met een API key. Om toegang te krijgen tot de API dient u het API key aanvraag formulier in te vullen: Aanvragen API-key voor Terugmelding API. Er wordt dan binnen enkele werkdagen een API key aangemaakt en naar u opgestuurd.
Documentatie over de API kunt u downloaden via de volgende URL in Open API Specification 3 (OAS3) als JSON formaat: https://verbeterdekaart.kadaster.nl/api-doc/terugmeldingapi.json
Een voorbeeld van de gewenste (Geo)JSON structuur en vulling van de velden vindt u hier: https://verbeterdekaart.kadaster.nl/api-doc/TerugmeldingGeneriekVoorbeeld.json
Ingeschoten terugmeldingen op de BGT en BRT zijn direct te bekijken op de acceptatie-omgeving van Verbeter de Kaart: https://verbeterdekaart.acceptatie.kadaster.nl/.
Let op: Omdat de API en documentatie in een acceptatie-omgeving staan, zit hier geen beveiligd certificaat op. De waarschuwing kunt u veilig negeren.
Ontwikkelproces API
Zowel de API als de documentatie zijn nog in ontwikkeling. Er zullen de komende periode nog wijzigingen worden doorgevoerd, waarbij het ook mogelijk is dat er breaking changes worden doorgevoerd.
Uiteraard is uw feedback bij deze verdere ontwikkeling erg belangrijk! We horen graag wat u opvalt aan de huidige API hier op het Geoforum, zodat we hierop onze ontwikkelingen kunnen aanpassen.
Livegang productie-omgeving
Het streven is om in de eerste helft van 2019 de productie-omgeving van de API te publiceren. Voor KLIC zal er dan een gefaseerde livegang van deze API plaatsvinden.
Known issues
De acceptatie omgeving kent zijn beperkingen. Daarnaast is de API nog in ontwikkeling. Houdt daarom met het volgende rekening:
- Omdat de API en documentatie in een acceptatie-omgeving staan, zit hier geen beveiligd certificaat op. De waarschuwing kunt u veilig negeren.
- Het is niet mogelijk om vanuit de acceptatieomgeving e-mails te sturen. Er zullen dus geen ontvangstbevestigingen van nieuwe terugmeldingen gestuurd worden, wanneer er een e-mailadres wordt opgegeven.
- Het is nog niet mogelijk om terugmeldingen met de status ‘Geparkeerd’ of ‘Doorgestuurd naar andere basisregistratie’ als filter op te halen.