Algemeen
Met een getekend certificaat kan men requests uitvoeren tegen de DOV REST API. Hiervoor dient volgend stappenplan gevolgd te worden:
- Definieer een HTTPS-connectie gebruikmakend van uw certificaat
- Stuur het request naar https://services.dov.vlaanderen.be/[APP]/[REST], waarbij
- APP de applicatienaam in DOV is die men 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 command 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
Voor de oefen omgeving kan de url https://services-oefen.dov.vlaanderen.be/dov-xdov-server/logs/count gebruikt worden
Voor java ontwikkelaars
Er is een java quickstart project beschikbaar die demonstreert hoe de services opgeroepen kunnen worden: https://github.com/DOV-Vlaanderen/dov-services-quickstart gemaakt
Heel specifiek, alles wat betreft het opbouwen van een secure connection met een certificaat staat 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 nog geen voorbeeldcode beschikbaar.
De beschrijving zoals bvb 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
In de subpagina's worden enkele voorbeelden aangehaald voor het gebruik van DOV REST API: