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 men je requests uitvoeren tegen de DOV REST API. Hiervoor dient dien je volgend stappenplan gevolgd te wordenvolgen:

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

...

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

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

...

Quickstart

Voor java ontwikkelaars

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

Hoe je Heel specifiek, alles wat betreft het opbouwen van een secure connection opbouwt met een certificaat staat in  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

Voor python ontwikkelaars

Hier is We hebben voorlopig nog geen voorbeeldcode beschikbaar.De beschrijving zoals bvb , maar je kan de beschrijving zoals bv. op https://www.techcoil.com/blog/how-to-send-a-http-request-with-client-certificate-private-key-password-secret-in-python-3/ gegeven wordt kan gevolgd worden volgen.

Voorbeelden

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

...