Onderhoud Wegens upgrade omwille van een kritieke kwetsbaarheid zal confluence vandaag (18/12/2023) om 14u00 even onbeschikbaar zijn.
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:
- Definieer een HTTPS-connectie gebruikmakend van je certificaat
- Stuur het request naar https://services.dov.vlaanderen.be/[APP]/[REST], waarbij
- APP de applicatienaam in DOV is die je wenst aan te spreken
- 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
Voor de oefen omgeving kan de url https://services-oefen.dov.vlaanderen.be/dov-xdov-server/logs/count gebruikt worden
Quickstart
Voor java ontwikkelaars
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
Voor python ontwikkelaars
We hebben voorlopig nog geen voorbeeldcode beschikbaar, 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/ volgen.
Voorbeelden
In de subpagina's worden enkele voorbeelden aangehaald voor het gebruik van DOV REST API: