Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

Overzicht foutmeldingen

Foutmeldingen die je ontvangen hebt tijdens het verwerken kan je terugvinden via de self-service pagina https://prod.notificaties.vlaanderen.be/ of via het antwoord dat je terugkrijgt van het aangesproken endpoint. In dat antwoord krijg je een beschrijving (“description”) en een detailoverzicht van alle gevonden foutmeldingen (“errors“).

Voorbeeld:

Code Block
languagejson
{
"code" : "2001",
"message" : "Validatiefouten",
"description" : "Er heeft zich een foutmelding voorgedaan. Gelieve contact op te nemen met het Notificatie team.",
"errors" : [ { "code" : "1100", "message" : "Maximum lengte voor body overschreden (80 KB).", "description" : "De maximum grootte voor een body is 80 KB.", "field" : "SleutelWaardeParen[0].Waarde" } 
]
}   

HTTP 401

Er is geen of geen geldig token in de Authorization Header, zie Beveiliging DOSIS via ACM/IDM. Vraag een token aan met

...

  • De dossierbron (met Bron-URI en Bron-ID) moet aangemaakt zijn voor de Afzender (= inhoudelijk verantwoordelijke) van de dossier- en toelatingsupdates

  • De ACM-client van de Aanbieder (= technisch verantwoordelijke) van v(an de updates moet de juiste rechten hebben en gekend zijn als Aanbieder voor de bron

...

De inhoud van de notificatie voldoet niet aan de vormvoorschriften. De respons ziet er als volgt uit:

Code Block
languagejs
{
  "code": "string",
  "message": "string",
  "description": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "description": "string",
      "field": "string"
    }
  ]
}

...

Krijgt u deze fout frequent, neem contact op met de Servicedesk of kom langs op het technisch spreekuur, wekelijks op dinsdag van 13:00 tot 14:00 uur. De limiet moet misschien verhoogd worden of er bestaat een betere aanpak om grote aantallen statusupdates te versturen. Zie ook de Performantietips hieronder.

Performantietips

...

Info

Gebruik het token niet tot het laatste moment omdat het ongeldig wordt tussen het moment dat het wordt opgestuurd en gevalideerd wordt. Dat leidt af en toe tot onverwachte HTTP 401 responses.
Een nieuw token is meestal een uur geldig. Vraag een nieuw token aan wanneer de resterende geldigheidsduur minder dan 1 minuut is. Zo bent u zeker dat het token geldig blijft voor de hele duurtijd van de volgende oproep.

...

  • de API trager is door hoge belasting, dan stuurt u ook trager notificaties updates door

  • een token gevalideerd moet worden, dan zijn alle andere oproepen met hetzelfde token geblokkeerd tot het resultaat van de validatie gekend is

  • u de bandbreedte en de verwerkingskracht deelt met alle andere aanbieders van DOSIS. Zie ook HTTP 429 respons

...