Voor ontwikkelaars
Het opendataportaal van de EU moedigt u aan de EU-datasets te gebruiken om nieuwe toepassingen te ontwikkelen. Hiervoor stellen we twee interfaces voor.
Het opendataportaal van de EU moedigt u aan de EU-datasets te gebruiken om nieuwe toepassingen te ontwikkelen. Hiervoor stellen we twee interfaces voor.
De eerste mogelijkheid is de REST API. Alle belangrijke functies van het portaal zijn beschikbaar via de API, zelfs meer dan wat u met de web-interface kunt doen. Al die informatie kunt u dus vanuit uw applicatie via de API oproepen.
De API is beschikbaar op: http://data.europa.eu/euodp/data/api/
Het opendataportaal van de EU is gebaseerd op CKAN. Op de website hiervan vindt u documentatie over de API.
Het formaat voor aanvragen en antwoorden is JSON (zie RFC 4627). Onderaan vindt u enkele voorbeelden van wat u met de REST API kunt doen.
Vanwege de infrastructuur van het Publicatiebureau zijn API-verzoeken die normaliter via de GET-methode van het HTTP-protocol beschikbaar zijn, via de POST-methode worden gedaan.
cURL is een generische http command-line tool die kan worden gebruikt om de API een vraag voor te leggen. Door bijvoorbeeld curl met het argument –d te gebruiken, kunt u het systeem dwingen de POST-methode te gebruiken, zelfs bij een lege lijst. Het wordt gebruikt in enkele voorbeelden hieronder.
Er zijn extensies voor de meest gangbare browsers, waarmee u vragen voor de API binnen de browser kunt opstellen, bijvoorbeeld Postman for Google Chrome en RESTClient for Mozilla Firefox.
U kunt de meeste programmeertalen gebruiken mits er een compatibele HTTP connection component is, zoals Jersey voor Java.
Er zijn speciale tools ontwikkeld voor het gebruik van de REST API. Al deze clients kunt u op Github vinden. U kunt ze gebruiken als uitgangspunt voor de ontwikkeling van uw eigen oplossing in een van de genoemde programmeertalen.
Geef een lijst van de datasets in JSON
curl http://data.europa.eu/euodp/data/api/3/action/package_list -d'{}'
Geef een lijst van de tags in JSON
curl http://data.europa.eu/euodp/data/api/3/action/tag_list -d'{}'
Geef een beschrijving van een bepaalde dataset in JSON
curl http://data.europa.eu/euodp/data/api/3/action/package_show -d'{"id": "dgt-translation-memory"}'
Zoek datasets of bronnen die aan een zoekopdracht beantwoorden
curl http://data.europa.eu/euodp/data/api/3/action/package_search -d'{"q": "forest"}'
Een andere toegangswijze voor het Opendataportaal van de EU is het machineleesbare SPARQL-endpoint waarmee u de RDF-beschrijvingen van datasets kunt doorzoeken.
Op de pagina "Linked data" vindt u een webinterface voor uw SPARQL-zoekopdrachten.
Voor programmeringsdoeleinden is een machineleesbaar endpoint beschikbaar op: http://data.europa.eu/euodp/sparqlep
Specificaties over SPARQL vindt u op de W3C-website: http://www.w3.org/TR/rdf-sparql-query/. De modellen die gebruikt worden om datasets op het opendataportaal van de EU te beschrijven, zijn te vinden op de pagina "Linked data" onder "Vocabularium metadata".
Om toepassingen te maken voor zoekopdrachten op het endpoint van het Opendataportaal van de EU kunt u libraries en toepassingen van derden gebruiken. Hieronder vindt u enkele voorbeelden.
Hier vindt u enkele libraries, ingedeeld volgens programmeertaal, die u kunt gebruiken om toepassingen te maken met de gegevens van het opendataportaal van de EU.
Voorbeelden van mogelijke zoekopdrachten vindt u op de pagina Linked data van het opendataportaal van de EU.