Inhoud

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.

Hou aub rekening met opmerkingen in onderstaande versioneringstabel. Ontwikkelingen zijn gestart dus zullen mogelijke wijzigingen nog minimaal zijn.

Datum Aanpassing	Basis	Wijzigingen (verwacht/uitgevoerd)
28 Apr 2020	Swaggers DIV 20 Mar 2020	Basisvertaling (uitgevoerd) OSLO compliance nog aan te vullen (verwacht) Aanpassingen op basis van vragen VLABEL: een vijftal ontbrekende velden (verwacht) Er komt in mei dus nog een nieuwe versie, zonder wijziging aan de functionaliteit (verwacht)
11 May 2020	Swaggers DIV 11 May 2020	Aanpassing op DIV swaggers van 11 mei meegenomen (uitgevoerd) OSLO compliance is opgenomen, enkel basis, moet nog gecorrigeerd worden (verwacht) Aanpassingen op basis van vragen VLABEL: een vijftal ontbrekende velden (verwacht) Midden juni komt een update van MAGDA swaggers op basis van een DIV revisie einde mei (verwacht)
16 Jun 2020	Swaggers DIV 12 Jun 2020	Een aantal aanpassingen aan de datastructuur van de diensten. Zie Wijzigingen 12 Juni 2020 - DIV REST diensten (uitgevoerd) Verbeterde OSLO implementatie van het Titular object in : Registrations RegistrationsTitular CrossborderTitular
26 Aug 2020	Swaggers DIV 26 Aug 2020	Een aantal aanpassingen aan de datastructuur van de diensten. Zie Wijzigingen 26 Augustus 2020 - DIV REST diensten De nieuwe swaggers zijn te vinden hieronder op deze pagina

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	Mobiliteit.GeefVoertuig-02.00	DIV REST - RegistrationsTitular
WSEListVehRegistration		DIV REST - Registrations
WSEListRegHis		DIV REST - RegistrationsHistory
WSEConsultVehRegistration		DIV REST - Registrations
WSEConsultVehRegHis		DIV REST - RegistrationsHistory
WSEConsultVehicle	Mobiliteit.GeefVoertuig-02.00	DIV REST - Registrations
WSEConsultVehicleTest		DIV REST - Registrations
WSEEuConsultTitPlate	Mobiliteit.GeefBuitenlandsVoertuig-02.00	DIV REST - CrossborderTitulars
MOVEMENTS (mutatiebestanden/ftp)	batchVerwerking LEZ	DIV REST - MovementIndications + DIV REST - Registrations

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: Token-gebaseerde diensten .

Hieronder het overzicht van de verschillende scopes en welke diensten ze bevatten:

Scope	Diensten
mob_cbt_v1_G	GET crossborderTitulars
mob_movind_v1_G	GET movementIndications/registrationsNew GET movementIndications/registrationsChangedDataLicense GET movementIndications/registrationsChangedDataVehicle GET movementIndications/registrationsTransferred GET movementIndications/registrationsUnregistered GET movementIndications/registrationsCrossedOut GET movementIndications/transactions
mob_reg_v1_G	GET registrations
mob_reghist_v1_G	GET registrationsHistory GET registrationsHistory/transactions GET registrationsHistory/certificates
mob_regtit_v1_G	GET registrationsTitular

Swaggers

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.

Impact op bestaande MAGDA diensten

Magda dienst	Impact
Mobiliteit.CheckVoertuiglijst-02.00	Impact gedragen door MAGDA platform, geen impact naar afnemers
Mobiliteit.ControleerToegang-02.00	Impact gedragen door MAGDA platform, geen impact naar afnemers
Mobiliteit.ControleerToegangOpDatum-02.00	Impact gedragen door MAGDA platform, geen impact naar afnemers
Mobiliteit.GeefBuitenlandsVoertuig-02.00	Dienst buiten gebruik bij afschakeling SOAP service door DIV. Afnemers moeten migreren naar DIV REST - CrossborderTitulars
Mobiliteit.GeefVoertuig-02.00	Dienst buiten gebruik bij afschakeling SOAP service door DIV. Afnemers moeten migreren naar DIV REST - RegistrationsTitular

Nieuwe DIV diensten