Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Beschrijving Vraag GET mobility/movementIndicators/transactions - v1

Detail

Element

Opmerkingen

Verplicht

Parameter type

x-correlation-id

Maakt deel uit van de header. Zie ook: Werking en overzicht uitzonderingen MAGDA RESTful services.

Dit is het transactie ID, gebruikt voor logging en foutafhandeling.

Ja

Header

X-Magda-Enduser-Id

Semantiek van dat veld: een referentie naar een END_USER.

Idee er achter: Indien er een probleem was met de afhandeling van een request die er kwam op vraag van een fysiek persoon en er iets mis gaat, kan er zo na de feiten (asynchroon) terug gekoppeld worden naar die persoon.

 Technisch gezien wordt er niets nagekeken.

Wat we wel vragen: Zet er zeker geen INSZ in, want dat zou inbreuken met zich mee kunnen brengen met privacy rulings.

Gebruik hem waar je een added value ziet voor uw toepassing.

Bvb. Indien de dienst geconsumed wordt door een proces, kan je er bvb een waarde in steken die dat proces identificeert.

Indien de dienst echt gebruikt wordt door een user die ergens gekend is in 1 van jullie applicaties, zou je er de ID van die user kunnen insteken (zodat enkel jullie die gebruiker kunnen terugvinden – indien nodig).

Ja

Header

date

Datum waarvoor de opvraging dient te gebeuren

Formaat: yyyy-mm-ddTuu:mm:ss

Ja

Request

vehicleCategory

VehicleCategory waarvoor er een opvraging dient te gebeuren.

Enkel waardes M1 en M2 zijn geldige waardes

Nee

Request

pagesize

Veld om aan te geven hoeveel resultaten per pagina u wilt krijgen.
Een maximum waarde van 400 is toegelaten op T&I. Indien een waarde groter dan 400 wordt opgegeven op T&I zal de bron een response code 400 gooien

Nee

Request

after

Query parameter om aan te geven na welk element de resultaten in het antwoord opgenomen dienen te worden.

Nee

Request

Validaties op vraag

Element

Omschrijving van de validatie

Mogelijke Foutcodes

alle elementen

De vraag dient minimaal de date parameter, inclusief waarde, bevatten

400 - Bad Request

pagesize

Het pagesize element mag maximaal 400 bedragen op T&I (limitatie bij de bron)

400 - Bad Request
Detail : “Unknown error from the source“

Voorbeeld

GET /movementIndications/transactions?date=2020-06-10

Op deze pagina


Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

 


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