Merk op, het afsprakenstelsel DSGO is nog in ontwikkeling. Zie de Aanpak ontwikkeling afsprakenstelsel voor meer informatie. Voor vragen of opmerkingen neem contact op met afsprakenstelseldsgo@digigo.nu

Hoe werkt een datadienst?

Een datadienst maakt het mogelijk om data te delen tussen een datadienstaanbieder en datadienstgebruiker en/of data te bewerken bij een datadienstaanbieder door een datadienstgebruiker. Allebei met toestemming van de datarechthebbende. Het rollenmodel geeft een gedetailleerde beschrijving van de rollen die betrokken zijn bij een datadienst.

In de onderstaande figuur worden de generieke interacties voor het uitvoeren van een datadienst weergegeven en in de tabel worden de acties beschreven.

Generiek patroon van een datadienst

#

Actie

Omschrijving

1

Datadienstverzoek

De datadienstgebruiker initieert de datadienst door middel van een datadienstverzoek naar de datadienstaanbieder.

2

Datadienstrespons

De datadienstaanbieder toetst het datadienstverzoek tegen het autorisatiebeleid van de datadienst en stuurt een geschikte response naar de datadienstgebruiker. In het geval van een positieve toets, inclusief het resultaat van de datadienst.

Volgens het afsprakenstelsel wordt data in een datadienst als resources beschikbaar gesteld. Een resource is een object met een type, bijbehorende data, relaties met andere resources en enkele operaties om deze te bewerken. Een datadienst krijgt vervolgens voor machine-to-machine interacties vorm via API's (Application Programming Interface), en voor human-to-machine interacties vorm via een applicatie, waarmee een operatie op de data resources uitgevoerd wordt. Applicaties voor human-to-machine interacties zijn de verantwoordelijkheid van de desbetreffende partijen, en niet in scope voor het DSGO.

Zie RESTful API’s voor een complete introductie van API’s en resources voor machine-to-machine interacties. Er zijn vier basisoperaties mogelijk in een datadienst om data delen en/of data bewerken mogelijk te maken. Deze vier operaties worden samengevat in de afkorting CRUD en gepresenteerd in de volgende tabel.

Operatie

Beschrijving

Create

De datadienstgebruiker stuurt data naar de datadienstaanbieder die op basis hiervan een data resource aanmaakt.

Read

De datadienstgebruiker ontvangt de gevraagde data resource van de datadienstaanbieder.

Update

De datadienstgebruiker stuurt data naar de datadienstaanbieder die op basis hiervan een data resource bijwerkt.

Delete

De datadienstgebruiker verzoekt de datadienstaanbieder om een data resource te verwijderen. De datadienstaanbieder verwijdert de data resource.

De DSGO structuur voor API’s die gebruikt kunnen worden in een datadienst worden hier verder beschreven.