1 Autoconnect CARWIZARD REST API voor historische Belgische voertuiggegevens Wat is het? Via de Autoconnect CARWIZARD REST API kunt u commerciële voer...
Autoconnect CARWIZARD REST API voor historische Belgische voertuiggegevens Wat is het? Via de Autoconnect CARWIZARD REST API kunt u commerciële voertuiggegevens opvragen van voertuigen (personenwagens en lichte vrachtwagens minder dan 3,5T) die momenteel niet meer op de Belgische markt te koop zijn, de zg. historische Belgische voertuiggegevens. Ook voor het opvragen van gegevens van gangbare voertuigen (nieuwe voertuigen nu op de markt) heeft Autoconnect CARWIZARD een REST service. Voor de specificaties daarvan verwijzen we naar de aparte documentatie van die dienst. Welke gegevens kunt u opvragen? Het opvragen van commerciële voertuiggegevens van een welbepaald voertuigtype gebeurt in 4 stappen: 1. Ophalen van een lijst met beschikbare merken 2. Ophalen van een lijst met beschikbare modellen van een merk 3. Ophalen van een lijst met beschikbare versies van een model 4. Ophalen van de details van een welbepaalde versie In het detail van een versie worden de beschikbare voertuiggegevens gegroepeerd in gegevensblokken volgens hun soort. De volgende gegevensblokken zijn beschikbaar: G: Algemene commerciële voertuiggegevens T: Technische voertuiggegevens M: Afmetingen van het voertuig Q: Standaarduitrustingen van het voertuig P: Opties en packs I: Speciaal blok met een optimale mix voor de verzekeringssector Voorbeelden van een aantal opvragingen en van de inhoud van de verschillende blokken vindt u verderop in dit document. Hoe wordt de REST service aangeroepen? Een opvraging gebeurt op basis van het aanroepen van een URL waarin een aantal variabelen in het pad worden geschreven. Het antwoord wordt telkens onder de vorm van XML weergegeven. Er is telkens een peildatum vereist, dat is de datum uit het verleden op welk ogenblik je naar de data wil kijken. De peildatum schrijven we altijd als YYYYMMDD. Ophalen van merken: http://api.inmotiv.be/rest/carwizard/makes/<APIkey>/
Ophalen van modellen onder een merk: http://api.inmotiv.be/rest/carwizard/models/<APIkey>//<merk-ID> Ophalen van versies onder een model: http://api.inmotiv.be/rest/carwizard/versions/<APIkey>//<model-ID> Ophalen van voertuigdetails: http://api.inmotiv.be/rest/carwizard/versiondetail/<APIkey>// Een voorbeeld van een blokkenlijst is: “GTMQ”: de blokken G, T, M en Q worden opgehaald. Het antwoord zal de gevraagde gegevensblokken in de XML bevatten. De API key is een code die wordt uitgereikt aan een geregistreerde gebruiker van onze toepassing. Aan de hand van de API key wordt het gebruik van de dienst gemeten en gefactureerd. Hoeveel kost het? De dienst wordt aangeboden volgens een transactie-gebaseerd model. Enkel de 2 laatste stappen, het ophalen van de lijst met versies onder een model, en het ophalen van de details (met prijs) is te betalen. Het ophalen van de merkenlijst en modellenlijst wordt niet aangerekend, maar er is wel een API key voor nodig. Voorbeelden: 1. Ophalen van merken: NL <MemberId>6 <MemberName>Impact Software Admin <Makelist> <Make makeid="88">ABARTH <Make makeid="1">ALFA ROMEO <Make makeid="3">ASIA <Make makeid="4">ASTON MARTIN <Make makeid="5">AUDI <Make makeid="7">BENTLEY <Make makeid="8">BMW <Make makeid="105">BMW ALPINA <Make makeid="11">CADILLAC <Make makeid="13">CHEVROLET <Make makeid="14">CHRYSLER <Make makeid="15">CITROEN <Make makeid="112">CORVETTE <Make makeid="111">DACIA <Make makeid="16">DAEWOO <Make makeid="17">DAIHATSU inMotiv Belgium
3. Ophalen van versies onder een model: In dit voorbeeld is het model: 3279 NL <MemberId>6 <MemberName>Impact Software Admin <Make makeid="47">PEUGEOT <Model modelid="3279">607 HDi Ivoire FAP42.0136DIESELSedanHDi Titane FAP42.0136DIESELSedanHDi Ivoire FAP Aut.42.7204DIESELSedanHDi Titane FAP Aut.42.7204DIESELSedan
