Adressenregister

Inleiding

Via de adressenregister connector is het mogelijk om gegevens voor een specifiek adres, gebouw of gebouwunit in Vlaanderen op te vragen.

Setup

Maven dependency

Om de connector te kunnen gebruiken, voeg je deze eerst als maven dependency toe aan het pom.xml bestand van je applicatie. Deze haalt de code voor de connector op bij het maken van de build voor je app.

CODE

<dependency>
   <groupId>com.skryv.connectors</groupId>
   <artifactId>adressenregister</artifactId>
   <version>${skryv.version}</version>
</dependency>

Onboardingsprocedure adressenregister

Hoewel je de API ook anoniem kan gebruiken, is het aangeraden om de onboardingsprocedure te doorlopen en een API key aan te vragen. Dit zorgt er ook voor dat je een groter aantal requests per seconde kan sturen.

Applicatie instellingen

Volgende applicatie eigenschappen kunnen ingesteld worden bij de technische setup van de Adressenregister-connector.

Let op: Applicatie-instellingen in application.properties kunnen worden overschreven door waarden die via terraform worden ingesteld als omgevingsvariabelen of door externe configuratiebronnen (zoals AWS Parameter Store of Secrets Manager).

Info volgt.

Resilience4j

Het adressenregister hanteert een maximum van 50 requests per seconde. Indien je dit debiet overschrijdt, dan krijg je een errorcode 429 Too Many Requests terug. Om dit te voorkomen, maken we gebruik van resilience4j en stellen we een maximale rate limit in.

Default instelling voor de adressenregister connector.

CODE

resilience4j.ratelimiter.instances.adressenregister.limit-for-period=1
resilience4j.ratelimiter.instances.adressenregister.limit-refresh-period=5s
resilience4j.ratelimiter.instances.adressenregister.timeout-duration=10s
resilience4j.retry.instances.adressenregister.max-attempts=3
resilience4j.retry.instances.adressenregister.wait-duration=1000

Services en functies