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 de pagina data_service_info verder technisch gedetailleerd. Hiermee wordt 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
Datadienstaanbieder contactpunt	Contactinformatie voor de datadienstaanbieder (bv. een e-mailadres of telefoonnummer)
Endpoint beschrijving	Een beschrijving van de API endpoints die door de datadienst worden gebruikt, inclusief de /capabilities, 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	Waar van toepassing, een verwijzing naar standaard(en) die het model, schema, ontologie, view of profiel waaraan de data zoals gebruikt in de datadienst aan voldoet
Ondersteund type datadienstgebruiker	Een beschrijving van welke type datadienstgebruikers ondersteund worden
Authenticatiemiddel	Een beschrijving van ondersteunde 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)