Veelgestelde vragen
Toegang / rechten
Ik mis de API rechten voor ....
Ga in de API Devportal naar Applications en selecteer de betreffende applicatie. Hier vindt u een lijst met de API's terug waar uw applicatie op geabonneerd is. Staat de betreffende API hier niet tussen dan kunt u deze aanmelden via het tabje APIS waar u de applicatie kunt inschrijven voor de gewenste API.
Bij het testen loop ik tegen het API limiet aan
Dit heeft te maken met de Subscription Tier van de applicatie. Om dit te wijzigen kunt u de applicatie opnieuw aanmelden in de API Devportal.
API Response
Wanneer ik mijn aanvraag ophaal is deze leeg
De API heeft een asynchroon karakter. Het kan daarom voorkomen dat een aanvraag nog niet geheel verwerkt is alvorens deze wordt opgehaald. Wanneer de aanvraag volledig verwerkt is wijzigt de status in de aanvraagwebapi:Aanvraag
van Nieuw naar Concept.
In productieomgeving bedraagd de verwerkingstijd minder dan een seconde ( < 1 sec ). In de sandbox omgeving kan de verwerkingstijd langer bedragen wanneer deze voor een langere periode inactief is geweest.
Bij het ophalen van mijn aanvraag krijg ik een 404 error
De API heeft een asynchroon karakter. Wanneer de aanvraag net is aangemaakt en daarna direct wordt opgevraagd kan het zijn dat deze nog niet volledig verwerkt is in het systeem; in die verwerkingsperiode kan het daarom voorkomen dat een 404 error wordt geretourneerd.
In productieomgeving bedraagd de verwerkingstijd minder dan een seconde ( < 1 sec ). In de sandbox omgeving kan de verwerkingstijd langer bedragen wanneer deze voor een langere periode inactief is geweest.
Ik krijg een "Provided Authorization Grant is invalid" error
Het kan zijn dat de autorisatie token welke je gebruikt niet langer geldig is. Let erop dat je na het vernieuwen van je access token de geretourneerde access en refresh tokens gebruikt.
GewensteDekkingsvorm
Ik krijg andere type dekkingen terug dan de opgegeven De API retourneert de goedkoopste dekking welke aan de minimale eisen voldoet. Hierdoor kan het voorkomen dat je een hogere dekking terugkrijgt dan WA, omdat:
- Er tarieven bestaan waar in sommige gevallen de Beperkt Casco dekking goedkoper is dan de WA dekking.
- Er tarieven bestaan (zoals ASR inruilplus) die alleen een Volledig Casco dekking aanbieden.
Om toch enkel WA dekkingen te tonen kunnen de waardes GewensteDekkingsvorm=WA
en MaximaalEigenRisico=0
opgevoerd worden in het profiel.
(Woonhuis) Ik krijg niet alle verzekeraars terug
Het veld Inhoud
(kubieke meters) is optioneel binnen het WoonhuisProfiel
; dit veld wordt echter wel gebruikt voor de tariefberekening en de bepaling van de beschikbare verzekeraars. Wanneer leeg probeert de API deze automatisch op te halen bij bekende databronnen maar wanneer ook deze geen resultaten opleveren blijft de waarde leeg.
Om het optimale aanbod te weergeven wordt daarom geadviseerd om de Inhoud
van het huis na te vragen bij de bezoeker indien deze leeg vanuit de API geretourneerd wordt.
Sandbox
Gebruikt de Sandbox omgeving een andere url?
Zowel de Sandbox als Productie omgeving gebruiken de url https://api.voogd.com. Op basis van de Consumer Key / Consumer Secret wordt er bepaald welke omgeving er gebruikt wordt.
Worden aanvragen in de Sandbox goedgekeurd?
Dit gebeurt enkel op verzoek, neem hiervoor contact op met Voogd & Voogd onder vermelding van het kenmerk van de aanvraag.
Overig
Hoe kan ik het logo van een maatschappij ophalen?
Hoewel de logo's van de maatschappijen niet langer in het datamodel zijn opgenomen, is het nog wel mogelijk om deze apart op te halen. Het ophalen van de logo's gebeurt op basis van het MaatschappijNummer
met onderstaande url.
https://media.voogd.com/maatschappij/{MaatschappijNummer}/logo.png?width=200
Hoe kan ik de ongeval inzittenden verzekering opgeven?
De ongeval inzittende verzekering is gebaseerd op de verzekerde som voor invaliditeit en overlijden. Deze kunnen opgegeven worden via het voordeelpakketberekening:PersonenautoProfiel
in de voordeelpakketberekening:Berekening
.