Als medewerker van gemeente X wil ik een kadasterpersoon een kadaster niet natuurlijk persoon en een ingeschreven niet natuurlijk persoon free query kunnen opzoeken

VNG-Realisatie / Haal-Centraal-BRK-bevragen

Project repository tbv de ontwikkeling van de Haal Centraal BRK Bevragen API

https://vng-realisatie.github.io/Haal-Centraal-BRK-bevragen/

Other

19 stars 15 forks source link

Als medewerker van gemeente X wil ik een kadasterpersoon een kadaster niet natuurlijk persoon en een ingeschreven niet natuurlijk persoon free query kunnen opzoeken #252

Open CathyDingemanse opened 4 years ago

CathyDingemanse commented 4 years ago

...zodat ik deze kan gebruiken te zoeken zoals gespecificeerd in de goals canvas.

Uitvoering team Ronald Peters

Acceptatiecriteria

Definition of done

[ ] functionele specificatie
[ ] Open API specificatie
[ ] gegenereerde code
[ ] testgevallen
[ ] referentie-implementatie

JohanBoer commented 4 years ago

Zoek-API bijgewerkt. Gaarne review.

JohanBoer commented 4 years ago

Er wordt geen aparte zoek-API voor het free-query zoeken op KOZ gemaakt. De locaties-server waar het BRK gebruik van maakt (Niet PDOK) kan op basis van free-query adres-zoeken een KOZ-id opleveren. Dat betekent dat het free-query zoeken straks toegevoegd wordt aan /kadastraleOnroerendeZaken als free-query zoek-parameter als team kadaster er aan toe is om dit te implementeren. Postcode Huisnummer etc worden voor V1 wel als query-parameter ondersteund.

fsamwel commented 4 years ago

@JohanBoer /kadasternatuurlijkpersonen en /kadasternietnatuurlijkpersonen hebben nu de free query zoekparameter "q". De BAG API /adressen/zoek gebruikt hiervoor "zoek", zoals ook in de API strategie wordt voorgesteld.

Voor consistentie wellicht handig om hier ook de parameter "zoek" te gebruiken

CathyDingemanse commented 4 years ago

Ik zou dat niet doen. In tegenstelling tot /kadasternatuurlijkpersonen en /kadasternietnatuurlijkpersonen is de BAG Zoek-API is geen REST API, maar een RPC service die tzt komt te vervallen als we wel een free query zoekparameter op de resource kunnen definiëren (en de identificatie van de resource geretourneerd kan worden). Ik wil maar zeggen: appels en peren hoeven niet consistent te zijn.