Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Een abonnement op een gebeurtenis is een gestandaardiseerde datadienst die de partij (die zich op voorhand heeft geabonneerd op meldingen over een (type) gebeurtenis) inlicht over deze gebeurtenis. Het concept van een abonnement is relevant voor veel partijen in de gebouwde omgeving. Om de werking van abonnementen te formaliseren in het DSGO definieert het afsprakenstelsel een abonnement als een gestandaardiseerde datadienst. Datadienstaanbieders Partijen (inclusief datadienstaanbieders) zijn niet verplicht een abonnement te implementeren. Een partij die kiest om een abonnement aan te bieden is vrij om een gebeurtenis te definiëren die voor haar relevant is. Deze termen worden in de tabel hieronder beschreven.

Een abonnement speelt een belangrijke rol wanneer een datadienstgebruiker (met toestemming van de datarechthebbende) op de hoogte gehouden wil worden van gebeurtenissen (bijvoorbeeld wijzigingen van de brondata) door middel van notificaties van de datadienstaanbieder op bepaalde resources. Deze termen worden in de tabel hieronder beschreven.

Term

Omschrijving

Gebeurtenis

Een identificeerbaar en specifiek voorval zoals gedefinieerd door de datadienstaanbieder. Bijvoorbeeld het wijzigen van de brondata.

Abonnement

Een overeenkomst tussen een datadienstaanbieder en een datadienstgebruiker (met toestemming van de datarechthebbende) om notificaties te ontvangen over de gedefinieerde gebeurtenissen.

Notificaties

Een melding van een gebeurtenis van de datadienstaanbieder, ontvangen door de datadienstgebruiker onder de voorwaarde van een abonnement.

...

Een verzoek op een abonnement wordt mogelijk gemaakt door een /subscriptions endpoint. Notificaties worden door partijen ontvangen door middel van een /notifications endpointwebhook url.

Excerpt
nameAbonnement op een gebeurtenis
Panel
panelIconId2705
panelIcon:white_check_mark:
panelIconText
bgColor#FFF0B3

DSGO.Basis: Als een partij een abonnement wil aanbieden in het DSGO dan MOET de partij dit mogelijk maken met een /subscriptions endpoint

Panel
panelIconId2705
panelIcon:white_check_mark:
panelIconText
bgColor#FFF0B3

DSGO.Basis: Als een partij een abonnement wil gebruiken in het DSGO dan MOET de partij notificaties kunnen ontvangen op een /notifications endpointwebhook url