Dit document beschrijft het gebruik en de werking van de webservice GeefBuitenlandsVoertuig 02.00 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.
Situering
Dit document beschrijft het gebruik en de werking van de webservice GeefBuitenlandsVoertuig 02.00 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.
Deze dienst maakt gebruik van 1 dienst bij DIV: FmvEuConsultTitPlateV01.
Gegevensbronnen
De gegevens worden opgeslagen in verschillende landen, maar worden allen op vraag ontsloten via de (authentieke) gegevensbron DIV.
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML).
Hiervoor moet men de Service-xsd gebruiken en niet de Webservice. Door de Service-xsd te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. Deze folder wordt tijdens het aansluitingsproces toegekend.
Als prefix voor de batchbestanden wordt “mobiliteit.geefbuitenlandsvoertuig-02.00” gebruikt.
Het bestand zelf dient deze vorm te hebben:
mobiliteit.geefbuitenlandsvoertuig-02.00_datumtijdstip.extensie
Vb. mobiliteit.geefbuitenlandsvoertuig-02.00_2018011809391234.xml
Prefix | mobiliteit.geefbuitenlandsvoertuig-02.00 |
---|
Voorbeeld | mobiliteit.geefbuitenlandsvoertuig-02.00_20131103115553530 |
---|
Functionaliteiten
Het doel van deze dienst is om gegevens van een buitenlands voertuig ter beschikking te stellen via het MAGDA platform. De bron voor deze gegevens is FOD Mobiliteit.
Deze dienst onderscheidt zich van de dienst GeefVoertuig 02.00 op verschillende vlakken:
Werking
Aandachtspunten
De afnemer is zelf verantwoordelijk voor correct aanroepen van de dienst. Dit door gebruik te maken van de nummerplaat, zonder speciale tekens die dienen om nummerplaat delen van elkaar te onderscheiden.
De DatumTijd uit de vraag dient in het verleden te liggen.
Opvraging
Momenteel laat de DIV dienst nog niet toe dat er gegevens opgevraagd kunnen worden in verschillende talen.
Momenteel geeft DIV ons nog geen technische gegevens terug van de voertuigen.
Momenteel ontsluit DIV enkel gegevens uit Nederland en Frankrijk.
Momenteel dient men voor opvragingen van gegevens uit Nederland of Frankrijk de gehele nummerplaat in Nummerplaat>Deel1 mee te geven, zonder speciale tussentekens (zoals een steepje of een punt).
Responsetijden & Beschikbaarheid
Logging
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".
Ondersteunde talen
MAGDA ondersteunt de Nederlandse taal.
Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.