Deze pagina werd gearchiveerd in 2023. Voor de meest recente versie, bekijk de bijgewerkte versie onder de tab 'Data aanleveren'.


Algemeen

Om gebruik te maken van DOV-webservices is een getekend certicaat nodig. 

Heb je nog geen certificaat? Lees dan in onze handleiding hoe je een certificaat kan aanmaken.

Met een getekend certificaat kan je requests uitvoeren tegen de DOV REST API. Hiervoor dien je volgend stappenplan te volgen:

  1. Definieer een HTTPS-connectie gebruikmakend van je certificaat
  2. Stuur het request naar https://services.dov.vlaanderen.be/[APP]/[REST], waarbij 
    1. APP de applicatienaam in DOV is die je wenst aan te spreken
    2. REST het url-patroon is om gegevens op te vragen of door te sturen


Testen van certificaat

De eenvoudigste manier om een certificaat te testen is om een cURL-commando te gebruiken:

testing certificates
curl -k https://services.dov.vlaanderen.be/dov-xdov-server/logs/count --key <full path to you private key> --cert <full path to your certificate> -v

Als je een time-out krijgt, is dit mogelijk te wijten doordat je netwerkverkeer via een proxy-server verloopt. Details hierover kan je best aanvragen bij je netwerkbeheerder. De proxy-gegevens voeg je dan toe met optie -x. Zo moeten gebruikers op het netwerk van de Vlaamse overheid -x proxy.vlaanderen.be:8080 toevoegen aan bovenstaande commando. 


Voor de oefen omgeving kan de url https://services-oefen.dov.vlaanderen.be/dov-xdov-server/logs/count gebruikt worden 

Quickstart

Java

Er is een java quickstart-project beschikbaar dat demonstreert hoe je de DOV-services kan oproepen:  https://github.com/DOV-Vlaanderen/dov-services-quickstart

Hoe je een secure connection opbouwt met een certificaat vind je specifiek in  https://github.com/DOV-Vlaanderen/dov-services-quickstart/blob/master/config/src/main/java/be/vlaanderen/dov/services/config/ClientConfig.java

Python

Het gebruik van Request met client side certificates is beschreven in bv. https://www.techcoil.com/blog/how-to-send-a-http-request-with-client-certificate-private-key-password-secret-in-python-3/. 

Er is een voorbeeldscript voor het invoeren van putten, filters en instrumenten via XML en json. Dit is een jupyter-notebook, te vinden het zipbestand instrumenten_api_demoscript-master.zip in bijlage.

Voorbeelden

In de subpagina's worden enkele voorbeelden aangehaald voor het gebruik van DOV REST API:

  • Geen labels