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 |
Een identificeerbaar en specifiek voorval zoals gedefinieerd door de datadienstaanbieder. Bijvoorbeeld het wijzigen van de brondata. | |
Een overeenkomst tussen een datadienstaanbieder en een datadienstgebruiker (met toestemming van de datarechthebbende) om notificaties te ontvangen over de gedefinieerde gebeurtenissen. | |
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 | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|