FAQ - technische info

Home
Terug naar algemene info over VHP
Terug naar overzicht veelgestelde vragen

Overzicht van vragen:

1 Waarom is een ISO2 code verplicht bij een belanghebbende?
2 Moeten we altijd eerst een GET doen van een belanghebbende?
3 Wat is een idempotency key en waarom moet ik deze gebruiken?
4 Hoe kunnen we API toegang verkrijgen?

Waarom is een ISO2 code verplicht bij een belanghebbende?

Wij synchroniseren elke belanghebbende met INSZ, KBO, VE of OVO-code uit een authentieke bron en bekomen zo de ISO2 code.
Indien een belanghebbende geen unieke referentienummer heeft om te synchroniseren vragen wij dat de ISO2 code wordt ingevuld. Dit is noodzakelijk om te kunnen kennisgeven.
Kennisgeving gebeurt via de MAGDA Documentendienst dewelke de verzorging hiervan doet via eBox of post. Voor de post is de ISO2 code een vereiste.

Moeten we altijd eerst een GET doen van een belanghebbende?

Indien je een POST doet van een belanghebbende met INSZ/KBO/VE/OVO en wij kennen die INSZ/KBO/VE/OVO, krijg je altijd de UUID van de bestaande belanghebbende terug.

PostBelanghebbende - Vlaams Handhavingsplatform - Confluence (atlassian.net) > Validatie 2.
Dat gezegd zijnde is er helemaal niets mis met altijd eerst een GET te doen.

Wat is een idempotency key en waarom moet ik deze gebruiken?

We verwijzen voor deze vraag door naar volgende pagina: https://vo-ajh.atlassian.net/wiki/spaces/VH/pages/149487653

Hoe kunnen we API toegang verkrijgen?

Het login endpoint in de swagger mag niet door aansluiters gebruikt worden. Voor de API moeten aansluiters een access token verkrijgen bij ACM (https://authenticatie.vlaanderen.be/docs/beveiligen-van-api/oauth-rest/rest-server2server/ ).