Aanleveren van dataset informatie via de API
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
- u hebt een goedgekeurd gebruikersaccount op data.overheid.nl
- u hebt een geldig email-adres opgegeven voor de afhandeling van eventuele vragen en dataverzoeken
- u bent data-eigenaar of mag handelen namens een data-eigenaar die voorkomt in onze lijst van data-eigenaren
- 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
- uw dataset informatie voldoet aan de DCAT-AP-NL standaard:
- alle verplichte velden zijn gevuld
- alleen toegestane waarden zijn opgenomen in de metadatavelden
- u heeft een unieke identifier als metadata opgenomen per dataset die in principe niet wijzigt en niet wordt hergebruikt
- u kiest zelf van welke datasets u informatie aanlevert
- 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?
- toegang tot een test-omgeving om uw opstelling voor de API koppeling te testen.
- voor uw bestaande gebruikersaccount 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 strict verbonden aan het betreffende account, aan één catalogus en aan de betreffende data-eigenaar.
- 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.