...
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.
...
Deze dient dus om duplicate request te voorkomen. Door een request te voorzien van deze key weten we dat het een nieuwe request is of een retry van een bestaandeHet VHP gebruikt de idempotency key om het onderscheid te maken tussen een nieuwe request en de retry van een vorige request.
Als de idempotency key nog niet is gebruikt dan wordt de request als nieuw beschouwt en zal de logica achter het endpoint aangeroepen worden.
Als de idempotency key in een vorige request is gebruikt dan zal de originele response teruggegeven worden en zal de logica achter het endpoint niet aangeroepen worden.
De idempotency key moet verschillend zijn per request, we stellen voor dat de aansluiters UUID v4 gebruiken voor het genereren van de key. Enkel als dezelfde request opnieuw word geprobeerd moet dezelfde idempotency key gebruikt worden.
Voorbeeld scenario
De HTTP request faalt omwille van een technisch probleem (bvb een timeout). De client heeft in dit scenario geen succesvolle response ontvangen en heeft geen zekerheid dat de request niet is behandelt door het VHP. Als dezelfde request hierna opnieuw geprobeerd word met een andere idempotency key zal het dossier 2x bestaan.
Hoe kunnen we API toegang verkrijgen?
...