Uitwisselen informatie met data.overheid.nl

Het register van data.overheid.nl wordt gevoed vanuit verschillende regionale, lokale en thema gebaseerde bronnen met dataset informatie. Op deze pagina's vindt u informatie over de wijze waarop de synchronisatie met verschillende bronnen plaatsvindt en hoe u zelf informatie kunt opvragen en/of toevoegen aan data.overheid.nl. 

Opvragen informatie uit data.overheid.nl

  • gebruik de API van CKAN voor het opvragen van dataset informatie in JSON.

Toevoegen van informatie aan data.overheid.nl

  • gebruik de API van CKAN [authenticatiesleutel is noodzakelijk] - volgens DCAT standaard.
  • harvesten van uw data door data.overheid.nl - volgens DCAT standaard.
  • maatwerk oplossing voor harvesten van data.

Verspreiding van dataset informatie

  • Europese dataportaal harvest alle datasets in data.overheid.nl. 

Overzicht

Onderstaande tekening laat de verschillende manier zien om dataset informatie toe te voegen aan data overheid (links in de tekening) en op te vragen (rechts in de tekening). De met *-gemarkeerde uitwisselingsmethoden zijn nog in ontwikkeling. 

uitwisseling.jpg

Drie manieren op dataset informatie op te vragen

  1. Via de browser. Op data.overheid.nl kunt u zoeken en bladeren door de inhoud van het dataregister
  2. Via de API. Via de CKAN API kunt u informatie opvragen in JSON formaat. 
  3. Via andere sites.  Een aantal organisaties nemen de informatie van data.overheid.nl (gedeeltelijk) over vanuit de API. Het Europese Dataportaal haalt bijvoorbeeld informatie over datasets op uit data.overheid.nl (in ontwikkeling). 

Binnenkort wordt een vierde manier toegevoegd om eenvoudig informatie over datasets op uw eigen website of intranet te tonen, de zogenaamde "widget" die u op uw eigen website kunt opnemen om te tonen welke data u in data.overheid.nl beschikbaar heeft. 

Drie manieren om dataset informatie toe te voegen 

Er zijn drie manieren om datasets in het dataregister van data.overheid.nl toe te voegen: 

  1. Handmatige invoer. Gebruikers met een goedgekeurd account kunnen via een beheerformulier datasets toevoegen en onderhouden. 
  2. Harvesting. In twee smaken: standaard DCAT en een maatwerk import functie die data.overheid.nl in principe alleen voor grote complexe catalogi toepast. 
  3. API. Gebruikers met een goedgekeurd account kunnen op de API van het register datasets aanbieden. Het is vereist dat de datasets voldoen een de DCAT standaard en het datamodel van data.overheid.nl volgen. 

Binnenkort wordt een vierde manier toegevoegd om dataset informatie te beheren. Het is een variant van de handmatige invoer. Als overheidsorganisatie (alleen rijksoverheid en in afstemming met betreffende kerndepartement) kunt u een "catalogus" op data.overheid.nl huren waarin u zelf uw eigen datasets beheert. In combinatie met de in ontwikkeling zijnde "widget" heeft u volledige controle over uw datasets en staan deze gelijk op het nationale dataportaal. Bij de huur is een beperkte dataopslag beschikbaar. 

Waarom automatisch synchroniseren?

Het harvesten van informatie of synchroniseren via de API heeft grote voordelen:

  • datasets worden slechts eenmaal aangemeld, ingevoerd en onderhouden
  • datasets worden door de broneigenaar op één plek onderhouden
  • één locatie waar alle datasets van Nederlandse overheden te vinden zijn, data.overheid.nl
  • data.overheid.nl zorgt dat alle datasets vindbaar zijn in het Europese Dataportaal.

Meer informatie over de uitwisseling van dataset informatie

  • Nationaal Georegister wordt door data.overheid.nl dagelijks geharvest. Op de pagina vindt u meer informatie over de wijze waarop dit plaatsvindt. 
  • Standaarden voor uitwisseling, zoals DCAT
  • Aanmelden voor uitwisseling via de API van uw eigen dataregister
  • Verkrijgen van de inhoud van data.overheid.nl via de API

Wilt u zelf datasets aanleveren? 

Neem contact met ons op voor meer informatie, of meldt u direct aan als "data-eigenaar" om een account voor handmatige invoer aan te maken. Alleen overheidsorganisaties kunnen worden goedgekeurd om als "data-eigenaar". Of lees meer over het automatisch synchroniseren (federatie) van uw eigen register