De Notification Client verstuurt de resource notification middels een HTTP POST van een Notification op het in de OAuth Client List aangetroffen Subscription Notification Endpoint.
ext.abo.rscnotint.201
3.
De resource notification hanteert de structuur: <base uri>/Notification (zonder andere parameters in de URL).
De twee parameters in de resource notification worden als volgt gevuld.
parameter
vulling
toelichting
subscription_id
De waarde waarmee de Subscription Server dit Abonnement in de subscription response heeft geïdentificeerd.
Een gebeurtenis bij een Aanbieder kan theoretisch leiden tot meerdere Notificaties. Iedere Notificatie hoort echter bij precies één Abonnement.
notification_type
De letterlijke waarde resource.
Zo kan de Notification Server de resource notification van de subscription notification onderscheiden.
Toelichting
Hier is niet, zoals in de subscription notification, een end_date opgenomen, omdat dat bij de hoofdfunctie Regie hoort. Communicatie over de Abonnementen-administratie vindt geheel plaats op het subscription notification interface. Het resource notification interface is alleen voor inhoudelijke notificaties. Mogelijk zal in toekomstige releases van het MedMij Afsprakenstelsel in de resource notification ook een nadere indicatie worden opgenomen van het onderdeel van de Gegevensdienst waarop er nieuwe informatie beschikbaar is.
ext.abo.rscnotint.204
6.
De enige parameter van de resource notification response wordt als volgt gevuld.
parameter
vulling
toelichting
notification_id
identificatie waarmee de Notification Serverde Notificatie uniek voor dit Abonnement identificeert
Hetidkan bijvoorbeeld een integer waarde zijn, of een UUID, maar kan ook volgens een ander geldig ID-patroon worden gevuld.
ext.abo.rscnotint.205
7.
Een Notification Client plaatsbinnen één (1) uur na het beschikbaar komen van nieuwe (gezondheids)informatie voor die Persoon betreffende die Gegevensdienst, een resource notification dienaangaande bij de betreffende Notification Server.
Toelichting
Als het tijdstip van beschikbaar komen van nieuwe (gezondheids)informatie wordt het moment gezien waarop betreffende informatie namens verwerkingsverantwoordelijke Aanbieder (handmatig of automatisch) als "beschikbaar voor Persoon" wordt aangemerkt.
ext.abo.rscnotint.206
8.
Na ontvangst van een resource notification, zal de Notification Server, indien in antwoord daarop een resource notification response dient te worden gedaan, na maximaal tien (10) seconden dit antwoord ter beschikking stellen aan de Notification Client. Dit gedrag van deNotification Serveris gedurende minimaal 98,5% van de tijd beschikbaar.
ext.abo.rscnotint.207
9.
Notification ServerenNotification Client handelen uitzonderingssituaties inzake het resource notification interface af volgens onderstaande tabel.
ConformHTTP specificatie met met status code 400 "Foute aanvraag", en met in de body de van toepassing zijnde error code ("invalid_subscription_id" of "invalid_notification_type")
Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering.
Wanneer Notification Client een error "invalid_subscription_id" ontvangt, dan dient het Abonnement direct te worden beëindigd, en wel zonder hiervoor opnieuw een notification te sturen.
Resource notification interface 2
Notificeren 2
Notification Serverkan in de request niet, niet geheel of niet tijdig verwerken.
