Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Beschrijving Vraag GET mobility/crossborderTitulars-v1

Detail

Element

Opmerkingen

Verplicht

Parameter Type

x-corrrelation-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 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 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

countryCode

Het land waarvan men de inschrijving opvraagt.
Formaat : ISO2 code in hoofdletters.

Ja

Query

plateNr1

De nummerplaat van het voertuig (deel 1)

Ja

Query

plateNr2

De nummerplaat van het voertuig (deel 2)

Nee

Query

dateTime

Query parameter om de datum waarvoor u de situatie wilt kennen mee te geven.

Indien er geen datum tijd wordt meegegeven, dan wordt standaard de datum van vandaag en tijd van aanvraag als dateTime genomen.

Het formaat moet een correcte date-time zijn volgens ISO-8601. Hierbij is een offset verplicht. Deze kan Z zijn voor Zulu of een tijd-offset.

vb1 : 2024-09-15T13:30:00+02:00
vb2 : 2024-09-15T11:30:00Z

Hou er rekening mee dat deze parameter correct URL encoded moet zijn. Het bovenstaand voorbeeld met de tijd-offset wordt dan 2024-09-15T13%3A30%3A00%2B02%3A00

OPGELET: de namen van parameters zijn case sensitive. Deze parameter gebruikt een hoofdletter T voor Time → dateTime

Nee

Query

Validaties op vraag

Element

Omschrijving van de validatie

Mogelijke Foutcodes

countryCode

Controleert of countryCode is ingevuld

400 - Bad Request

plateNr1

Controleert of plateNr1 is ingevuld

400 - Bad Request

Voorbeeld

Voorbeeld vraag met countryCode en plateNr1 - GET /registrations?countryCode=[landnummer]&plateNr1=[nummerplaat1]

GET /crossborderTitulars?countryCode=FR&plateNr1=72XY123

 

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