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)