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 erachter: 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 gebruikt wordt door een proces kan je er bvb een waarde in steken die dat proces identificeert.
Indien de dienst echt gebruikt wordt door een gebruiker 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. indien niet opgegeven wordt een waarde van 400 aangenomen.
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.
400 - Bad Request Detail : “pageSize larger than 400“
Voorbeeld
Voorbeeld
GET /movementIndications/registrationsNew?date=2020-06-10&pagesize=200