Datadienstspecificatie

Datadiensten gebaseerd op het afsprakenstelsel moeten helder gedefinieerd zijn zodat datadienstaanbieders weten wat nodig is voor implementatie en (potentiële) datadienstgebruikers de beschikbare datadiensten kunnen beoordelen en gebruiken. De onderstaande tabel geeft een overzicht van de elementen die deel uitmaken van een datadienstspecificatie in het DSGO. Het doel van deze tabel is het expliciet maken van alle elementen die nodig zijn voor een duidelijk gespecificeerde datadienst.

Deze elementen worden op in capability_info object en data_service_info object verder gedetailleerd. Hiermee wordt de onderstaande datadienstspecificatie gestandaardiseerd voor communicatiedoeleinden binnen het DSGO.

Element

Beschrijving

Element

Beschrijving

Datadienst titel

De titel van de datadienst

Datadienst beschrijving

Een korte beschrijving van de datadienst en het doel ervan

Versie

Het versienummer van de datadienst

Datadienstaanbieder naam

De naam van de datadienstaanbieder

Datadienstaanbieder identifier

De Organisatie ID van de datadienstaanbieder (als EORI of KvK nummer) dat kan worden gebruikt om de datadienstaanbieder te identificeren

Datadienstaanbieder contactpunt

Contactinformatie voor de datadienstaanbieder (bv. een e-mailadres of telefoonnummer)

Endpoint beschrijving

Een beschrijving van het API endpoint dat door de datadienst wordt gebruikt, inclusief de resources, operaties en file formats ervan (bv. beschreven in YAML-formaat)

Endpoint URL

De URL die wordt gebruikt om toegang te krijgen tot de datadienst

Semantisch data model

Een (verwijzing naar een) gevestigde standaard die het model, schema, ontologie, view of profiel waaraan de data gebruikt in de datadienst aan voldoet (opmerking: er kunnen meerdere verwijzingen zijn)

Kosten

Een beschrijving van de kosten die een datadienstaanbieder een datadienstgebruiker in rekening brengt voor het gebruik van de datadienst.

Ondersteund type datadienstgebruiker

Een beschrijving van welke type datadienstgebruikers ondersteund worden

Authenticatiemiddel

Een beschrijving van ondersteunden authenticatiemiddelen. Alleen van toepassing bij type datadienstgebruiker mens namens partij of mens namens zichzelf.

Betrouwbaarheidsniveaus

Vereist betrouwbaarheidsniveau van de identificatie van datadienstgebruikers die nodig is voor gebruik van de datadienst. Alleen van toepassing bij type datadienstgebruiker mens namens partij of mens namens zichzelf.

Beveiligingsniveau

Vereist niveau van beveiliging van de datadienst

Toegangscontroleregels

Beleid of richtlijnen waar aan moet worden voldaan voordat er gebruik kan worden gemaakt van de datadienst (bv. de noodzaak van een certificering of kennis van een ordernummer)

Verplichtingen en advies

Beleid of richtlijnen waar aan moet worden voldaan nadat er gebruik is gemaakt van de datadienst (bv. de gebruiksomvang, het beleid inzake gegevensbewaring en rapportagevereisten). Dit bevat onder andere een licentie

Service level agreements (SLAs)

Alle service level agreements over de dienstverlening of prestatiegaranties gerelateerd aan de datadienst.(bv. garanties inzake uptime of reactietijd)

Â