Algemeen

Via deze dienst kan een leerbewijs voor een bepaalde INSZ geregistreerd worden.

Parameters

Element

Type

Opmerkingen

x-correlation-id

Header

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.

Validaties op vraag

Element	Omschrijving van de validatie	Mogelijke Foutcodes
INSZ	Moet voldoen aan aan checksum 97	400 - Bad request

Detail element

Element	Opmerkingen	Primaire parameter	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.	Nee	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
plateNr	Query parameter om de nummerplaat van het voertuig mee te kunnen geven. De nummerplaat dient zonder spaties of leestekens te worden meegegeven (vb.: 1AAA123)	Ja	Nee	Query
plateUID	Query parameter om de unieke identificatie van het License object gelinkt aan een nummerplaat mee te kunnen geven. Deze identifier wordt als resultaat gegeven in bv de movementindications diensten.	Ja	Nee	Query
vin	Query parameter om het chassisnummer van het voertuig mee te kunnen geven.	Ja	Nee	Query
unifier	Uniek identificatienummer van de nummerplaat. Dit veld mag enkel in combinatie met de parameter "vin" gebruikt worden	Nee	Nee	Query
certificateId	Query parameter om het unieke identificatienummer van het certificaat mee te kunnen geven.	Ja	Nee	Query
nationalNr	Query parameter om het rijksregisternummer van een persoon mee te kunnen geven.	Ja	Nee	Query
companyNr	Query parameter om het ondernemingsnummer van een bedrijf mee te kunnen geven.	Ja	Nee	Query
dateTime	Query parameter om de datum waarvoor u de situatie wilt kennen mee te geven. Indien er geen datum wordt meegegeven, dan wordt standaard de datum van vandaag als zoekdatum genomen. Formaat: yyyy-mm-ddTuu:mm:ssZ	Nee	Nee	Query
transactionUID	Query parameter om het uniek identificatienummer van een transactie mee te kunnen geven.	Ja	Nee	Query
pageSize	Veld om aan te geven hoeveel resultaten per pagina u wilt krijgen.	Nee	Nee	Query
after	Query parameter om aan te geven na welk element de resultaten in het antwoord opgenomen dienen te worden.	Nee	Nee	Query
addressEnrichmentPerson	Query parameter om aan te geven bij welke Bron de recente adresgegevens van de titularis, in geval van Natuurlijk persoon, opgehaald dienen te worden. Mogelijke waardes zijn "RR" (rijksregister) en "KSZ". Indien geen verrijking noodzakelijk kan de parameter weggelaten worden	Nee	Nee	Query
addressEnrichmentOrganization	Query parameter om aan te geven bij of adres verrijking voor onderneming dient plaats te vinden. Mogelijk parameter waarden zijn "True" of "False"	Nee	Nee	Query

Voorbeeld

Beschrijving Vraag GET Mobility/registrations - v1

Voorbeeld

Headers Request:
X-Magda-Enduser-ID=Information retracted
X-Correlation-ID=Information retracted
Authorization=Bearer *Information retracted==
X-Magda-Sender-ID=kb.vlaanderen.be/Information retracted
X-Magda-Sender-QualityCode=123
X-Magda-ServiceDomain=led
X-Magda-ServiceName=bewijzen/bewijzenMetControle
X-Magda-ServiceVersion=1
Executed Request: POST https://Information retracted
ParametersFile: /rest/bewijzenBewijzenMetControlePostdienst/request/Information retracted
Request: {
  "synchronousProcessing": true,
  "request": {
    "referte": "ABC/ABC/ABCD/2018/00001",
    "naamLeverancier": "ABCD",
    "insz": "01234567891",
    "instantieId": "ABC123456",
    "instantieDoelgroep": "AB",
    "uitreikingsdatum": "2021-08-20",
    "volledigeNaam": "Lorem Ipsum",
    "instellingNaam": "Lorem Ipsum",
    "instellingNummer": "0123456789",
    "specialisatieNaam": "Lorem ipsum dolor sit amet",
    "specialisatieCode": "ABCD A",
    "detailOnderwerpNaam": "string",
    "detailOnderwerpCode": "string",
    "urenVolwassenOnderwijs": "string",
    "alternatieveInstanties": [
      {
        "instellingsrol": "string",
        "naam": "string"
      }
    ],
    "bijkomendeInformatie": [
      {
        "naam": "string",
        "inhoud": "string"
      }
    ]
  }
}

Op deze pagina

Binnen deze handleiding

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

Beschrijving Vraag (POST bewijzen/bewijzenMetControle)

Algemeen

Parameters

Validaties op vraag

Detail element

Voorbeeld

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid