Autoconnect CARWIZARD REST API voor gangbare Belgische voertuiggegevens Wat is het? Via de Autoconnect CARWIZARD REST API kunt u commerciële voertuiggegevens opvragen van NIEUWE voertuigen (personenwagens en lichte vrachtwagens minder dan 3,5T) die momenteel op de Belgische markt te koop zijn, de zg. gangbare Belgische voertuiggegevens. Ook voor het opvragen van gegevens van niet meer gangbare voertuigen (uit het verleden) 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. 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>//GTMQ In dit voorbeeld worden de blokken G, T, M en Q 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="4">ASTON MARTIN <Make makeid="5">AUDI <Make makeid="7">BENTLEY <Make makeid="8">BMW <Make makeid="47">PEUGEOT
2. Ophalen van modellen onder een merk: In dit voorbeeld is het merk-id: 47, Peugeot. NL <MemberId>6 <MemberName>Impact Software Admin <Make makeid="47">PEUGEOT inMotiv Belgium
3. Ophalen van versies onder een model: In dit voorbeeld is het model: 4459 NL <MemberId>6 <MemberName>Impact Software Admin <Make makeid="47">PEUGEOT <Model modelid="4459">508 SW BlueHDI Business Line51.6115 inMotiv Belgium
DIESELBreake-HDI Access FAP ETG STT41.6115DIESELSedanVTI Access BMP51.6116BENZINEBreakVTI Active BMP51.6116BENZINEBreakTHP Active AUT SST (EU6)51.6165BENZINEBreak
4. Ophalen van voertuigdetails: In dit voorbeeld is de versie: 15061560 en vragen we het blok I op:
(uittreksel, herhalingen zijn niet volledig opgenomen) NL <MemberId>6 <MemberName>Impact Software Admin <Make makeid="47">PEUGEOT <Model modelid="4459">508 SW BlueHDI Business Line <Makename>PEUGEOT inMotiv Belgium
<MainCategoryNameFR>Veiligheid ZichtbaarheidVisibilité <EquipmentNameNL>Reglementair plaatje op de zonneklep <EquipmentNameFR>Plaquette réglementaire sur le paresoleil QJ01 <Equipment mainsequence="C" sequence="C7"> <MainCategoryNameNL>Veiligheid <MainCategoryNameFR>Veiligheid Gordels en airbagsCeintures de sécurité et airbags <EquipmentNameNL>Frontale airbags, laterale airbags voorin, gordijnairbags voor- en achterin <EquipmentNameFR>Airbags frontaux, airbags latéraux avant, airbags rideaux avant et arrière NF04 <Equipment mainsequence="C" sequence="C8"> <MainCategoryNameNL>Veiligheid <MainCategoryNameFR>Veiligheid Wettelijke kitKit légal <EquipmentNameNL>Wettelijke kit : 10 liter brandstof, een verkeersdriehoek, een verbanddoosje, ee <EquipmentNameFR>Kit légal : 10 litres de carburant, un triangle, une trousse de secours, un exti <Equipment mainsequence="D" sequence="D1"> <MainCategoryNameNL>Comfort <MainCategoryNameFR>Comfort Audio, tv en 12v accessAudio, tv et access <EquipmentNameNL>Peugeot Connect Sound : radio met mp3compatibel cd-speler en bediening aan het <EquipmentNameFR>Peugeot Connect Sound : radio avec lecteur CD compatible MP3 et commandes au vol <Equipment mainsequence="D" sequence="D1"> <MainCategoryNameNL>Comfort <MainCategoryNameFR>Comfort Audio, tv en 12v accessAudio, tv et access <EquipmentNameNL>Peugeot Connect SOS: noodoproep met localiseringsfunctie + Peugeot connect nav <EquipmentNameFR>Peugeot Connect SOS: appel d'urgence localisé + Peugeot connect nav WLXX <Equipment mainsequence="G" sequence="G"> <MainCategoryNameNL>Diversen <MainCategoryNameFR>Diversen inMotiv Belgium
