RESTful diensten - info
Algemeen
DIV heeft einde 2019 aangekondigd dat het in de loop van 2020 de SOAP diensten zal vervangen door nieuwe REST diensten die op een vernieuwd, performanter platform zullen draaien. Deze pagina’s beschrijven de nieuwe diensten zoals MAGDA ze zal aanbieden.
MAGDA zal de nieuwe DIV REST diensten aanbieden in REST formaat, en daarin de datastructuren van DIV overnemen. Elke DIV REST dienst zal dus beschikbaar worden op het MAGDA platform.
Opmerking:
Hou aub rekening met opmerkingen in onderstaande versioneringstabel. Ontwikkelingen zijn gestart dus zullen mogelijke wijzigingen nog minimaal zijn.
Datum Aanpassing | Basis | Wijzigingen (verwacht/uitgevoerd) |
---|---|---|
Apr 28, 2020 | Swaggers DIV Mar 20, 2020 |
|
May 11, 2020 | Swaggers DIV May 11, 2020 |
|
Jun 16, 2020 | Swaggers DIV Jun 12, 2020 |
|
Aug 26, 2020 | Swaggers DIV Aug 26, 2020 |
|
Sep 21, 2020 | Swaggers DIV Aug 26, 2020 |
|
Sep 28, 2020 | Swaggers DIV Aug 26, 2020 |
|
Oct 20, 2020 | Swaggers DIV Aug 26, 2020 |
|
Nov 30, 2020 | Swaggers DIV Nov 27, 2020 |
|
Feb 8, 2021 | Swaggers DIV Nov 27, 2020 | Uitbreiding functionaliteit in diensten registrationsTitular en registrations. Optioneel kunnen de diensten registrationsTitular en registrations vanaf nu ook het actuele adres van de titularis teruggeven in het antwoord. Dit adres is in het antwoord beschikbaar onder “currentAddress”. Deze wijziging is volledig optioneel en 100% backward compatible. Het adres dat de diensten registrationsTitular en registrations door DIV wordt terug gegeven moet als “adres bij inschrijving” geïnterpreteerd worden. Dit adres is dus niet geschikt om te gebruiken als adres waarnaar communicatie gestuurd kan worden. De functionaliteit van het actuele adres is nog in ontwikkeling en wordt in T&I verwacht tegen half februari. Deze pagina bevat wel al de aangepaste swaggers. |
Migratie van de SOAP naar de REST diensten
Onderstaande lijst geeft een overzicht van de verschuiving van de oude SOAP diensten naar de nieuwe REST diensten. Er is geen 1 op 1 vervanging daar de REST diensten een aggregatie van informatie betekenen. Daarnaast zullen de FTP exports vervangen worden door een REST dienst waardoor afnemers genoodzaakt zijn om de mutaties zelf op te vragen in plaats van deze aangeboden te krijgen.
Oude DIV SOAP dienst | Gebruikt in MAGDA dienst | Vervangen door DIV REST dienst |
---|---|---|
WSEConsultTitPlate | ||
WSEListVehRegistration | ||
WSEListRegHis | ||
WSEConsultVehRegistration | ||
WSEConsultVehRegHis | ||
WSEConsultVehicle | ||
WSEConsultVehicleTest | ||
WSEEuConsultTitPlate | ||
MOVEMENTS (mutatiebestanden/ftp) | batchVerwerking LEZ | GET mobility/movementIndications/* - v1 + GET mobility/registrations - v1 |
Authenticatie
De service consumer vraagt een OAuth token aan op de DIV OAuth server dat vervolgens gebruikt wordt om de effectieve service call te doen. Dit is een standaard proces voor alle aansluitingen via REST diensten op MAGDA, ook voor alle andere domeinen.
Dit token wordt meegegeven bij de request naar de REST dienst. Verdere uitleg over het OAuth token en het opvragen ervan: ACM OAuth - Token-gebaseerde diensten MAGDA .
Hieronder het overzicht van de verschillende scopes en welke diensten ze bevatten:
Scope | Diensten |
---|---|
mob_cbt_v1_G |
|
mob_movind_v1_G |
|
mob_reg_v1_G |
|
mob_reghist_v1_G |
|
mob_regtit_v1_G |
|
Swaggers
Impact op bestaande MAGDA diensten
Magda dienst | Impact |
---|---|
Mobiliteit LEZ ControleerToegangOpDatum - CSV batch verwerking | Impact gedragen door MAGDA platform, geen impact naar afnemers |
Impact gedragen door MAGDA platform, geen impact naar afnemers | |
Impact gedragen door MAGDA platform, geen impact naar afnemers | |
Dienst buiten gebruik bij afschakeling SOAP service door DIV. Afnemers moeten migreren naar GET mobility/crossborderTitulars - v1archived | |
Dienst buiten gebruik bij afschakeling SOAP service door DIV. Afnemers moeten migreren naar GET mobility/registrationsTitular - v1 |
Op deze pagina
Binnen deze handleiding
Verwante diensten
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