Versions Compared

Version Old Version 31 New Version 32
Changes made by

Peter Ebraert (Deactivated)

Bram De Clerck

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Datum Aanpassing

Basis

Wijzigingen (verwacht/uitgevoerd)

Swaggers DIV

  • 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)

Swaggers DIV

  • 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)

Swaggers DIV

  • 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

Swaggers DIV

Swaggers DIV

  • Toevoegen HTTP statuscode 204 (in anticipatie van uitbreiding DIV swaggers met HTTP status code 204)

  • De nieuwe swaggers zijn te vinden hieronder op deze pagina

Swaggers DIV

  • Toevoegen header parameter “X-Magda-Enduser-Id”

    • De nieuwe parameter is een verplichte parameter waarin de gebruiker van de dienst een referentie dient mee te geven over welke user/welk proces verantwoordelijk is voor het aanroepen van de dienst. Aanroeper van de dienst moet op verzoek van DIV de referentie terug kunnen brengen naar de effectieve gebruiker die de dienst heeft gebruikt.

  • verwijderen van registationsHistory/transactions & registrationsHistory/certificates in de beschikbare swaggers

    • beide diensten zijn niet beschikbaar voor regionale afnemers.

Swaggers DIV

  • Correctie van datatype datetime naar date-time in swaggers registrationsHistory, registrations, registrationsTitular.

Swaggers DIV

  • toevoeging van het element legalFormAbbrev in de response van registrations en registratoinsTitular

Swaggers DIV

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.

Info

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.

Note

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.

Info

Om het actuele adres te kunnen opvragen bij de respectievelijke bronnen is een machtiging vereist. Het actuele adres zal dus enkel aanwezig zijn in de dienst indien de afnemer over deze machtiging beschikt.

Migratie van de SOAP naar de REST diensten

...

Oude DIV SOAP dienst

Gebruikt in MAGDA dienst

Vervangen door DIV REST dienst

WSEConsultTitPlate

Mobiliteit.GeefVoertuig-02.00

DIV REST - RegistrationsTitular GET mobility/registrationsTitular - v1

WSEListVehRegistration

GET mobility/registrations - v1 CCC

WSEListRegHis

GET mobility/registrationsHistory - v1 CCC

WSEConsultVehRegistration

GET mobility/registrations - v1 CCC

WSEConsultVehRegHis

GET mobility/registrationsHistory - v1 CCC

WSEConsultVehicle

Mobiliteit.GeefVoertuig-02.00

GET mobility/registrations - v1 CCC

WSEConsultVehicleTest

GET mobility/registrations - v1 CCC

WSEEuConsultTitPlate

Mobiliteit.GeefBuitenlandsVoertuig-02.00

GET mobility/crossborderTitulars - v1

MOVEMENTS (mutatiebestanden/ftp)

batchVerwerking LEZ

GET mobility/movementIndications - v1 + GET mobility/registrations - v1 CCC

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.

...

View file
nameMobility-OSLO-2020113020210208.zip

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 GET mobility/crossborderTitulars - v1

Mobiliteit.GeefVoertuig-02.00

Dienst buiten gebruik bij afschakeling SOAP service door DIV. Afnemers moeten migreren naar DIV REST - RegistrationsTitular GET mobility/registrationsTitular - v1