Datastructuur notificatie

Owned by Dennis de Gouw
Jan 24, 2024
2 min read

versie: 22-05-2023 Status: definitief

Incrementele implementatie
Het iWlz-netwerkmodel wordt incrementeel geïmplementeerd aan de hand van het afsprakenstelsel iWlz-netwerkmodel. Het eerste deel dat wordt geïmplementeerd is het Indicatieregister. Dit artikel geeft weer hoe de datastructuur in deze implementatiestap wordt geimplementeerd.

Dit artikel geeft inzicht in de structuur van de notificatieberichten. Notificatieberichten worden op twee plekken gebruikt:

  • Notificatie van een resource server van de bronhouder naar de autorisatie server van de bronhouder

  • Notificatie van ‘web services register' van de bronhouder naar 'web services afnemer’ van de afnemer

1. Notificatie naar autorisatie server indicatieregister

De notificatie van resource server naar de autorisatieserver is een HTTP POST-request. Het endpoint van de autorisatie server is https://api.vecozo.nl/netwerkmodel/v2/luarunner/callback.

Met dit request moet een geldig clientcertificaat (VECOZO-systeemcertificaat) worden meegestuurd. Dit certificaat wordt door de autorisatie server gevalideerd.

De body van de notificatie ziet er als volgt uit:

{ "organisatieId" : "<code van te notificeren deelnemer>",   "organisatieIdType" : "string",   "timestamp" : "string",   "abonnementId" : "string",   "eventType": "string",   "recordId": "https://api.ciz.nl/wlzindicatieregister/wlzindicaties/123" }

De specificaties voor de vulling van de elementen zijn in de uitwisselprofielen opgenomen.

2. Notificatie naar web services afnemer indicatieregister

De notificatie naar de afnemer dient te worden verstuurd naar het notificatie endpoint van de afnemer. Deze notificatie is momenteel een HTTP GET-request.

Hierbij wordt een querystring gebruikt met de volgende elementen:

  • authorization_code

  • organisatie_id

    • In deze querystring wordt ook de organisatieID meegegeven (statisch opgenomen in de endpoint).

Tevens is het mogelijk andere statische gegevens in de querystring mee te geven, zoals bijv. een organisatie_code en subscription_key

De key values dienen als volgt te worden gevuld:

{ "authorization_code" : "C62PbtgLJtcS3yVLcmHgY1U94U2k1qNwT-bAMhFryaE=", "organisatie_id" : "5501" (voorbeeldwaarde) }

Deze dienen als querystring te worden verstuurd:

GET https://<base_url>?authorization_code=C62PbtgLJtcS3yVLcmHgY1U94U2k1qNwT-bAMhFryaE=&organisatie_id=5501

De ontvanger van de notificatie controleert bij een binnenkomend notificatie of deze afkomstig is van nID door middel van het gebruikte VECOZO-systeemcertificaat.

N.B. Na de eerste implementatiestap zal bovenstaande GET-request worden omgezet in een POST-request.

Â