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.
| Note |
|---|
Hou aub rekening met opmerkingen in onderstaande versioneringstabel. De definitieve versie waartegen ontwikkeld wordt, is in fase van afronding (mid juni verwacht afgewerkt). |
Datum Aanpassing | Basis | Verwachte wijzigingen |
|---|---|---|
| Swaggers DIV |
|
| Swaggers DIV |
|
| Swaggers DIV |
|
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 ipv 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 | DIV REST - MovementIndications - old + DIV REST - Registrations - old |
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 is te vinden in onderstaande PDF.
| View file | ||
|---|---|---|
|
Swaggers
| Note |
|---|
De swaggers hieronder zijn een voorlopige versie. Ze worden beschikbaar gesteld om afnemers een idee te geven van wat de diensten zullen inhouden, en dienen bv als basis om inschatting te maken van effort in het project. Zowel de query parameters als de inhoud van het bericht kunnen wijzigen. We geven verder bericht via deze pagina van al dan niet bereiken van een definitieve versie, cf versiegeschiedenis. |
| View file | ||
|---|---|---|
|
Impact op bestaande MAGDA diensten
Magda dienst | Impact |
|---|---|
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 DIV REST - Crossborder - old | |
Dienst buiten gebruik bij afschakeling SOAP service door DIV. Afnemers moeten migreren naar DIV REST - RegistrationsTitular - old |