...
Er is geen of geen geldig token in de Authorization Header, zie Beveiliging DOSIS via ACM/IDM . Vraag een token aan met
scope dv_dosis_import
...
de juiste “audience” voor de omgeving
...
Deze fout komt soms voor omdat eenzelfde token te lang gebruikt wordt. Zie onder bij de ACM token performantie tips Performantietips.
HTTP 403
Deze fout geeft aan dat je ACM client De ACM-client heeft niet de nodige rechten heeft om het dossier of de toelating aan te passen. Deze rechten worden toegekend door het Aansluitingenteam Aansluitingen-team tijdens het aansluiting procesaansluitingsproces:
De Dossier Bron dossierbron (met Bron Uri -URI en Bron Id-ID) moet aangemaakt zijn voor de Afzender (= inhoudelijk verantwoordelijke) van de dossier- en toelating updatestoelatingupdates
De ACM-client van de Aanbieder (= technisch verantwoordelijke) van de updates moet de juiste rechten hebben en gekend zijn als Aanbieder voor de bron
De foutboodschap die je terugkrijgt ziet er als volgt uit en zal duidelijker aangeven wat er fout ging:
| Code Block | ||
|---|---|---|
| ||
{
"code": "string",
"message": "string",
"description": "string"
} |
Je Zodra de aansluitingsgegevens aangepast zijn kan deze update later onveranderd opnieuw aanbieden, zodra de aansluitingsgegevens aangepast zijnworden aangeboden.
HTTP 400
De inhoud van de notificatie voldoet niet aan de vereistenvormvoorschriften. De respons die je terugkrijgt isziet er als volgt uit
| Code Block | ||
|---|---|---|
| ||
{
"code": "string",
"message": "string",
"description": "string",
"errors": [
{
"code": "string",
"message": "string",
"description": "string",
"field": "string"
}
]
} |
...
| Info |
|---|
|
...
validatieboodschappen zijn. |
De message- en description-velden geven aan wat er fout was. Sowieso zal de De dossier- of toelating-update wordt niet aanvaard worden met de huidige inhoud.
HTTP 429
De DOSIS-API wordt beschermd door een Application Firewallapplication firewall. Indien Zodra er teveel calls tegelijk komen, dan krijg je een error 429 “Too many requests.” Als je deze fout krijgt, open dan je “Circuitbreaker” en probeer geeft dit de foutboodschap: 429 - Too many requests. Open uw Circuitbreaker en probeer het later opnieuw.
De huidige limiet is 1800 oproepen per minuut. Let wel: dit is een globale limiet, voor alle gebruikers van de API. Het is dus ook mogelijk dat je een 429 fout krijgt, niet omdat je zelf te snel de API oproept, maar u deze fout ziet omdat andere gebruiker(s) een groot aantal oproepen doen.
Krijg je Krijgt u deze fout frequent, contacteer dan het DOSIS team of breng het onderwerp op op het wekelijks “Technisch Spreekuur”. Mogelijk moet de limiet verhoogd worden of is er 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 status updates statusupdates te versturen. Zie ook de performantietips hieronder voor performantie tips.
Performantietips
ACM-Token
Als je Wanneer u meerdere updates verstuurt, probeer dan hergebruik zoveel mogelijk één ACM-token te hergebruiken.
Een ACM-token aanmaken en valideren is vaak het traagste deel van een update versturen/verwerken. DOSIS valideert een ACM-token slechts 1 maaléén keer, bij de eerste oproep met dat token. Daarna wordt de validatie gecached gecachet en zijn alle volgende oproepen met dat datzelfde token een stuk sneller.
Als je Wanneer u een token ontvangt van ACM, bevat de respons een “expiresexpires_in” in-veld dat aangeeft hoelang het token nog geldig is.
| 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. |
Performantie van
...
dossiers of
...
toelatingsupdates versturen
Stuur updates bij voorkeur sequentieel opwanneer:
als de API wat trager is door hoge belasting, dan stuur je stuurt u ook wat trager notificaties door
als een token gevalideerd moet gevalideerd worden, dan zijn alle andere oproepen met hetzelfde token geblokkeerd tot het resultaat van de validatie gekend is
je deelt u de bandbreedte en de verwerkingskracht deelt met alle andere aanbieders van DOSIS. Zie ook de HTTP 429 respons als er teveel notificaties tegelijk aangeboden worden
...