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.
-
Het retourneren van data a.d.h.v. een Bearer token: deze OpenAPI specificatie.
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.