Getting Started

De ‘BRP tabellen bevragen’ Web API is gespecificeerd in OpenAPI specifications (OAS).

Wil je de API gebruiken? Dit kun je doen:

  1. Bekijk de functionaliteit en specificaties
  2. Implementeer de API
  3. Probeer en test de API

Functionaliteit en specificaties

Met deze API kun je:

  • een overzicht vragen van de beschikbare landelijke tabellen in de API
  • een landelijke tabel zoeken op een (een deel van) de omschrijving
  • een omschrijving raadplegen bij een code in een landelijke tabel
  • een code zoeken bij (een deel van) de omschrijving in een landelijke tabel

Zoeken in de BRP tabellen API is case insensitive en ondersteunt het gebruik van wildcard karakter *.

Standaard levert de API bij het zoeken geen beëindigde tabelwaarden, zoals landen die niet meer bestaan. Je kunt ook beëindigde waarden vinden door de parameter inclusiefbeeindigd=true op te nemen in het request.

Je kunt een visuele representatie van de specificatie bekijken met Swagger UI of Redoc.

Je kunt de functionele documentatie vinden in de features.

Implementeer de API

Je kunt code genereren op basis van de genereervariant van de specificaties.

Probeer en test

Wil je de ‘BRP tabellen bevragen’ Web API proberen en testen? Kijk op: https://www.haalcentraal.nl/haalcentraal/api/landelijke_tabellen

Om de web api te gebruiken heb je een apikey nodig. Deze voeg je aan een request toe als header “X-API-KEY”. Een API-key vraag je aan bij de product owner cathy.dingemanse@denhaag.nl.

De tabellen in de Haal Centraal probeeromgeving worden niet bijgehouden. Dit zijn dus niet de actuele tabellen.

Je kan de Haal Centraal probeeromgeving niet gebruiken vanuit de browser, dus ook niet vanuit de browserversie van Postman. Gebruik dus de desktopversie van een testtool (zoals Postman) om berichten te sturen.

Importeer de specificaties in Postman

De werking van de API is het makkelijkst te testen met behulp van Postman. We hebben al een Postman collection voor je klaargezet. Deze kun je importeren in Postman.

Configureer de url en api key

  1. Klik bij “Landelijke tabellen” op de drie bolletjes.
  2. Klik vervolgens op Edit
  3. Selecteer tabblad “Authorization”
  4. Kies TYPE “API Key”
  5. Vul in Key: “x-api-key”, Value: de API key die je van Cathy hebt ontvangen, Add to: “Header”
  6. Selecteer tabblad “Variables”
  7. Vul bij baseUrl INITIAL VALUE en bij CURRENT VALUE: https://www.haalcentraal.nl/haalcentraal/api/brphistorie
  8. Klik op de knop Update