Acceptatiecriteria nieuwe integraties
Nieuwe integratoren wordt gevraagd om eerst een aantal testen op de T&I (test- en integratie) omgeving uit te voeren alvorens we de aansluiting kunnen activeren in productie.
Voor dienstenleveranciers die een integratie opzetten en vervolgens de oplossing aan meerdere partijen aanbieden zal deze validatie enkel voor de eerste aansluiting doorlopen moeten worden.
Bijkomende aansluitingen kunnen vervolgens onmiddellijk in productie opgezet worden omdat de integratie dan reeds gevalideerd werd.
Gebruik correlation ID
Alle API requests dienen voorzien te zijn van een unieke correlation ID. Zo kunnen supportvragen omtrent technische fouten sneller behandeld worden.
Aandachtspunten POST messages
Gebruik van idempotency keys om dubbele zendingen te vermijden.
Bewaar de documentID die in de response terugkomt, dit is namelijk de unieke referentie van een zending en dient gebruikt te worden om later de status ervan op te kunnen vragen.
Maximale load
Onze API gateway (Apigee) handhaaft een aantal rate limits. Zorg dat de applicatie hiermee overweg kan.
Als er teveel api calls gebeuren zal je een 429 response terugkrijgen en dien je het aantal requests te verlagen.
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen