Datasets publiceren

Publicatie van datasets op data.overheid.nl

Deze informatie is alleen relevant voor overheidsorganisaties die een dataset willen toevoegen aan het dataportaal. 

3 manieren om datasets aan te melden

1. Handmatig op data.overheid.nl. Hiervoor maakt u eerst een account aan als data-eigenaar. Vervolgens voert u de dataset in via het formulier 'aanmelden dataset'
2. Automatisch via andere dataportalen zoals het Nationaal Georegister of het Centraal Bureau voor de Statistiek. Alle datasets die zijn aangemeld bij het Nationaal Georegister worden automatisch op data.overheid.nl overgenomen. U hoeft hier niets voor te doen.
3. Automatisch vanuit uw eigen dataportaal. Heeft u een eigen dataregister of een eigen dataportaal? U hoeft de gegevens niet opnieuw in te voeren op data.overheid.nl. De leverancier van uw dataportaal kan u meer vertellen over de mogelijkheden. Daarnaast kan data.overheid.nl uw portaal ook harvesten. Neemt u in dat geval contact op met het team van data.overheid.nl over de mogelijkheden via data@koop.overheid.nl

Manier één: Aanmeldproces

Om u te helpen bij het handmatig publiceren van datasets op data.overheid.nl is er een handleiding geschreven.

Manier twee en drie: Automatisch publiceren

Het register van data.overheid.nl wordt gevoed vanuit verschillende regionale, lokale en thema gebaseerde bronnen met dataset informatie. Op deze pagina 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. 

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

• Het Europese Dataportaal harvest alle datasets in data.overheid.nl. 

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 bron-eigenaar op één plek onderhouden;
• één locatie waar alle datasets van de Nederlandse overheid te vinden zijn, namelijk: 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 gebeurt.
• 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". Het is mogelijk om informatie over (een deel van) uw datasets automatisch aan te leveren aan data.overheid.nl. Data.overheid.nl biedt hiervoor de standaard CKAN API aan. Er zijn een aantal voorwaarden om data te kunnen aanleveren bij data.overheid.nl

Organisatorische voorwaarden voor aanlevering

1. U hebt een goedgekeurd data-eigenaars account op data.overheid.nl.
2. U hebt een geldig e-mail-adres opgegeven voor de afhandeling van eventuele vragen en dataverzoeken.
3. U bent data-eigenaar of mag handelen namens een data-eigenaar die voorkomt in onze lijst van data-eigenaren.
4. U hebt aantoonbare toestemming om namens een overheidsorganisatie datasets aan te melden waarbij de betreffende organisatie de data-eigenaar is van de aangeleverde datasets.

Technische voorwaarden

1. Uw dataset informatie voldoet aan de DCAT-AP-NL standaard: 

• alle verplichte velden zijn gevuld;
• alleen toegestane waarden zijn opgenomen in de metadatavelden.

1. U heeft een unieke identifier als metadata opgenomen per dataset die niet wijzigt en niet wordt hergebruikt.
2. U kiest zelf van welke datasets u informatie aanlevert.
3. U heeft zelf voorzieningen getroffen om de API van data.overheid.nl met een vaste frequentie te kunnen aanroepen en informatie aan te leveren.

Vervolg actie

Kunt u aan bovenstaande voorwaarden voldoen? Zoek dan contact met ons via opendata@overheid.nl, en geef hierbij aan dat u interesse heeft om data aan te leveren via de API. In een (telefonische) afstemmingsgesprek nemen we de voorwaarden en eventuele vragen door. 

Wat krijgt u van data.overheid?

1. Toegang tot een test-omgeving om uw opstelling voor de API koppeling te testen. 
2. Voor uw bestaande data-eigenaar account op data.overheid.nl ontvangt u een API-KEY die nodig is om informatie via de API toe te voegen aan data.overheid.nl. De API key is strikt verbonden aan het betreffende account, aan één catalogus en aan de betreffende data-eigenaar.  
3. Een overeenkomst waarin de belangrijkste afspraken zijn vastgelegd. 

N.B. de aanlevering via de API omvat GEEN datastorage op data.overheid.nl. U verzorgt zelf de opslag van uw data en levert bij data.overheid.nl alleen een link naar de data aan. 

Contact voor ondersteuning

Lukt het u niet om uw datasets aan te melden? Neem contact met ons op voor extra ondersteuning.