Beste mede-forummers,
Intro
Voor een applicatie (nog in ontwikkeling) van De Geschillencommissie probeer ik connectie te maken met de BAG API V2 (omdat V1 uitgefaseerd gaat worden).
Hiervoor heb ik de documentatie geraadpleegd op github . Middels Postman probeer ik enkele calls uit te voeren, om de mogelijkheden te verkennen.
Wat wel lukt
Een call naar V1 gaat goed vanuit Postman:
https://bag.basisregistraties.overheid.nl/api/v1/nummeraanduidingen?postcode=9781NR&huisnummer=31
met in de header mijn key als ‘X-Api-Key’ geeft netjes een identificatiecode en andere relevante data.
Wat (nog) niet lukt
Nu wil ik bijvoorbeeld de bronhouder opvragen middels een bronhouder code. Dit zou volgens de matrix beschikbaar moeten zijn.
Hiervoor kijk ik naar het bestand bronhouders.yaml.
Ik gebruik deze url als endpoint: https://api.bag.kadaster.nl/lvbag/individuelebevragingen/v2
En zet in de header mijn key als ‘apiKeyBAG’.
Als ik dit stuk van de yaml file lees:
- name: Bronhouder
description: Dit endpoint levert één of meer bronhouder(s).
paths:
/bronhouders/{identificatie}:
get:
tags:
- Bronhouder
summary: Bevragen bronhouder, op basis van de bronhouder identificatie (gemeentecode).
description: |-
“Bevragen/raadplegen van een bronhouder, via de identificatie van een bronhouder (gemeentecode).
Geleverd wordt een bronhouder.
Parameter identificatie bevat de 4 cijferige identificatie van een bronhouder (gemeentecode).
Als geldigOp en/of beschikbaarOp niet wordt opgegeven, worden de actuele gegevens geleverd.”
operationId: bevragenBronhouder
parameters:
- name: identificatie
in: path
description: Een officiële code die aan een gemeente is toegekend, ontleend
is aan tabel 33.
required: true
style: simple
explode: false
schema:
pattern: ^[0-9]{4}$
type: string
example: “0226”
Interpreteer ik dat als dat ik de GET-request zo moet opbouwen:
https://api.bag.kadaster.nl/lvbag/individuelebevragingen/v2/bronhouders/0518
Dit geeft helaas een 400 error.
Andere varianten die ik heb geprobeerd geven allen ook een zelfde 400 error:
https://api.bag.kadaster.nl/lvbag/individuelebevragingen/v2/bronhouders/“0518”
https://api.bag.kadaster.nl/lvbag/individuelebevragingen/v2/bronhouders?bevragenBronhouder=0518
https://api.bag.kadaster.nl/lvbag/individuelebevragingen/v2/bronhouders?bevragenBronhouder=“0518”
https://api.bag.kadaster.nl/lvbag/individuelebevragingen/v2/bronhouders?identificatie=0518
Helaas kan ik uit de 400 error geen verdere informatie halen; de body en header zijn leeg.
Zie ik wellicht iets simpels over het hoofd, of heeft iemand anders dit ook ervaren? Iedere tip in de goede richting is welkom. Alvast bedankt.
Met vriendelijke groet,
Jelle de Rijke
