Download PDF
Download page URL's publieke REST services.
URL's publieke REST services
Uitleg
REST (Representational State Transfer) is een stijl van software architecture voor het ontwerp van netwerk applicaties. Het fundamentele concept van een RESTful API is de 'resource'. Alle informatie die benoemd kan worden is een resource: een (gegenereerd) diagram, document, afbeelding, verzameling (collection) van resources, etc. In het geval van de BRO is dit bijvoorbeeld een Registratie Object. REST gebruikt een resource identifier om een resource te identificeren.
De status van een resource op een willekeurig moment heet een 'resource representation' en bevat data, metadata die de data omschrijft en hypermedia links die de gebruikers helpen het object te interpreteren.
Het data formaat van een 'resource representation' staat bekend als een 'media type' en stelt vast hoe de resource representation verwerkt moet worden.
Daarnaast zijn registratie-objecten gegroepeerd in registratiedomeinen. Dit is terug te vinden in de URL (/gm voor grondwatermonitoring, /sr voor bodem- en grondonderzoek). In de toekomst is de verwachting dat op domein niveau nieuwe functionaliteit wordt gerealiseerd.
De uitgifte REST services zijn bedoeld voor "incidenteel" gebruik. Ze zijn niet geschikt voor uitgifte in bulk. Hiervoor zijn atom feeds beschikbaar. De operaties op kenmerken / karakteristieken zijn dan ook niet bedoeld om middels steeds verfijndere, op basis van geografisch kenmerken, uitgifte te bewerkstelligen (zogenaamde "tiling"). In de toekomst zullen deze operaties hoogstwaarschijnlijk worden beschermd op overvragen ("throttling").
Aanpassing URL's: in december 2021 hebben wij onze URL's aangepast zodat zij compliant zijn aan de REST Designrules van de NL overheid . De voormalige URL's (voorbeeldlink: https://publiek.broservices.nl/gm/gld-v1.0/) zijn in april 2022 uit productie genomen.
URL's
Hier onder staan de URL's van de beschikbare REST services. Met de weergegeven URL kom je in de productieomgeving terecht.
Voor de demo-omgeving of de acceptatie-omgeving kun je de bijbehorende REST services benaderen door toevoeging van 'int-' respectievelijk 'acc-' voor 'publiek'. Voorbeeld: https://int-publiek.broservices.nl/gm/gmw/v1/
Domein grondwatermonitoring
Uitgifte
- GMW uitgifte
link: https://publiek.broservices.nl/gm/gmw/v1
- GLD uitgifte
nieuwe link: https://publiek.broservices.nl/gm/gld/v1 - GMN uitgifte
nieuwe link: https://publiek.broservices.nl/gm/gmn/v1 - GAR uitgifte
nieuwe link: https://publiek.broservices.nl/gm/gar/v1
Visualisatie
- GMW Materiƫle geschiedenis (tijdlijn)
nieuwe link: https://publiek.broservices.nl/gm/gmw/v1/material-history - GLD Visualisatie waterstanden
nieuwe link: https://publiek.broservices.nl/gm/gld/v1/waterlevel
Domein bodem- en grondonderzoek
Uitgifte
- CPT uitgifte
link: https://publiek.broservices.nl/sr/cpt/v1 - BHR-P uitgifte
link: https://publiek.broservices.nl/sr/bhrp/v2 - BHR-GT uitgifte
link: https://publiek.broservices.nl/sr/bhrgt/v2 - BHR-G uitgifte
link: https://publiek.broservices.nl/sr/bhrg/v2 - SFR uitgifte
link: https://publiek.broservices.nl/sr/sfr/v2
Visualisatie
- Publieke visualisatieservice BHR-GT 2.1 boorprofielen
link: https://publiek.broservices.nl/sr/bhrgt/v2/profile - Publieke visualisatieservice CPT grafieken
link: https://publiek.broservices.nl/sr/cpt/v1/result
BRO algemene services
Waardelijsten
Het is mogelijk om een lijst met alle waarden (uit de catalogi) op te vragen bij de LV BRO via een REST-service.
Waardelijst Service
link: https://publiek.broservices.nl/bro/refcodes/v1
In de openAPI specificatie van de service zelf is een uitleg opgenomen, de zogeheten Swagger-uitleg.
Aanpassing URL refcodes: in december 2021 hebben wij onze URL's aangepast zodat zij compliant zijn aan de REST Designrules van de NL overheid . De voormalige URL (https://publiek.broservices.nl/refcodes/api/) is sinds april 2022 niet meer beschikbaar..