Acceptatiecriteria nieuwe integraties


DIGITAAL VLAANDEREN

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