Terug

Documentatie verstrekker (middels component generiek-verstrekken)

Data uitwisseling met generiek-verstrekken

De component generiek-verstrekken zorgt voor het aannemen van de data-aanvragen van afnemers en zal zorgen voor het distribueren van de aanvraag naar dataproducten. Deze dataproducten dienen deze OpenAPI specificatie te implementeren v.w.b. het request deel.

De datastructuur van de response wordt bepaald door het dataproduct. De (interne) URL is ook vrij te kiezen. Deze is in te stellen in het generiek-verstrekken component per dataproduct dienst. Dien hiervoor een merge request in op de configmap.yaml waar de backends staan opgenomen. Plaats daarbij de variabelen in de omgevingsbestanden in de root van het project.

De applicatie generiek-verstrekken zal de aanvraag van een afnemer valideren. Daarbij wordt de aanwezigheid en geldigheid van het vereiste JWT-token gevalideerd. Indien correct zal er een verzoek worden gedaan naar het juiste dataproduct. De aanvraag bevat 1 of meerdere EAN’s en eventueel extra meegegeven parameters voor het dataproduct. Bij het aanmaken van een dataproduct dient een URL opgevoerd te worden waar documentatie over het datamodel en eventueel extra parameters is beschreven. Deze URL dient publiek bereikbaar te zijn.

Architectuur

De applicatie generiek-verstrekken is ontwikkeld met Java 21 en Spring Boot. Het is ontworpen om de communicatie met het autorisatieregister te mediƫren. Hiervoor stelt de applicatie HTTP-endpoints beschikbaar. Deze dienen via het internet ontsloten te worden zodat afnemers met het systeem kunnen communiceren. Momenteel is er 1 HTTP-endpoint.

Code en Docker container generiek-verstrekken

De broncode van de applicatie generiek-verstrekken wordt kosteloos en onder een permissieve Open Source licentie ter beschikking gesteld aan alle belangstellenden. Bovendien is een Docker image beschikbaar voor het gebruik in een container-omgeving zoals Kubernetes.

Op dit moment zijn wij nog hard bezig om deze publiek bereikbaar te maken. Tot die tijd verwijzen we u graag door naar uw contactpersoon bij EDSN.