Autoconnect CARWIZARD REST API voor gangbare Belgische voertuiggegevens

Transcriptie

1 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: Ophalen van modellen onder een merk: Antwerpen F inmotiv.be

2 Ophalen van versies onder een model: Ophalen van voertuigdetails: 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: <Cardata> <Request> <Language>NL</Language> <MemberId>6</MemberId> <MemberName>Impact Software Admin</MemberName> </Request> <Makelist> <Make makeid="88">abarth</make> <Make makeid="1">alfa ROMEO</Make> <Make makeid="4">aston MARTIN</Make> <Make makeid="5">audi</make> <Make makeid="7">bentley</make> <Make makeid="8">bmw</make> <Make makeid="47">peugeot</make> </Makelist> </Cardata> 2. Ophalen van modellen onder een merk: In dit voorbeeld is het merk-id: 47, Peugeot. <Cardata> <Request> <Language>NL</Language> <MemberId>6</MemberId> <MemberName>Impact Software Admin</MemberName> <Make makeid="47">peugeot</make> </Request> 2050 Antwerpen F

3 <Modellist> <Model modelid="4737"> <Modelname>108</Modelname> <Category categoryid="1">stadswagen</category> <Segment segmentid="2">b</segment> <Model modelid="4552"> <Modelname>208</Modelname> <Category categoryid="1">stadswagen</category> <Segment segmentid="2">b</segment> <Model modelid="4453"> <Modelname>iOn</Modelname> <Category categoryid="1">stadswagen</category> <Segment segmentid="2">b</segment> <Model modelid="4231"> <Modelname>Bipper</Modelname> <Category categoryid="11">utilitair voertuig</category> <Segment segmentid="13">utilitair</segment> <Model modelid="4086"> <Modelname>Boxer</Modelname> <Category categoryid="11">utilitair voertuig</category> <Segment segmentid="13">utilitair</segment> <Model modelid="4118"> <Modelname>Expert</Modelname> <Category categoryid="11">utilitair voertuig</category> <Segment segmentid="13">utilitair</segment> <Model modelid="4272"> <Modelname>Partner New</Modelname> <Category categoryid="11">utilitair voertuig</category> <Segment segmentid="13">utilitair</segment> </Modellist> </Cardata> 3. Ophalen van versies onder een model: In dit voorbeeld is het model: 4459 <Cardata> <Request> <Language>NL</Language> <MemberId>6</MemberId> <MemberName>Impact Software Admin</MemberName> <Make makeid="47">peugeot</make> <Model modelid="4459">508 SW </Request> <Versionlist> <Version versionid=" "> <Versionname>BlueHDI Business Line</Versionname> <Numberofdoors>5</Numberofdoors> <PowerHp unit="hp">115</powerhp> 2050 Antwerpen F

4 <Fueltype>DIESEL</Fueltype> <Bodyworktype>Break</Bodyworktype> <Version versionid=" "> <Versionname>e-HDI Access FAP ETG STT</Versionname> <Numberofdoors>4</Numberofdoors> <PowerHp unit="hp">115</powerhp> <Fueltype>DIESEL</Fueltype> <Bodyworktype>Sedan</Bodyworktype> <Version versionid=" "> <Versionname>VTI Access BMP</Versionname> <Numberofdoors>5</Numberofdoors> <PowerHp unit="hp">116</powerhp> <Fueltype>BENZINE</Fueltype> <Bodyworktype>Break</Bodyworktype> <Version versionid=" "> <Versionname>VTI Active BMP</Versionname> <Numberofdoors>5</Numberofdoors> <PowerHp unit="hp">116</powerhp> <Fueltype>BENZINE</Fueltype> <Bodyworktype>Break</Bodyworktype> <Version versionid=" "> <Versionname>THP Active AUT SST (EU6)</Versionname> <Numberofdoors>5</Numberofdoors> <PowerHp unit="hp">165</powerhp> <Fueltype>BENZINE</Fueltype> <Bodyworktype>Break</Bodyworktype> </Versionlist> </Cardata> 4. Ophalen van voertuigdetails: In dit voorbeeld is de versie: en vragen we het blok I op: (uittreksel, herhalingen zijn niet volledig opgenomen) <?xml version="1.0" encoding="utf-8"?> <Cardata> <Request> <Language>NL</Language> <MemberId>6</MemberId> <MemberName>Impact Software Admin</MemberName> <Make makeid="47">peugeot</make> <Model modelid="4459">508 SW <Version verid=" ">bluehdi Business Line </Request> <Block type="i" name="basic Insurance Block"> <Makename>PEUGEOT</Makename> 2050 Antwerpen F

5 <Modelname>508 SW</Modelname> <MaxNetPowerkW unit="kw">84</maxnetpowerkw> <MaxNetPowerHp unit="hp">115</maxnetpowerhp> <FuelType>DIESEL</FuelType> <CO2Combined unit="g/km">100</co2combined> <NumberOfSeats>5</NumberOfSeats> <BodyworkType>Break</BodyworkType> <TotalCylinderCapacity unit="cm3">1560</totalcylindercapacity> <CatalogPrice unit="eur" VAT="excl">20 300,00</CatalogPrice> <Block type="g" name="general Car Data Block"> <Versionname>BlueHDI Business Line</Versionname> <TaxableHp>9</TaxableHp> <VersionID> </VersionID> <GearBox/> <Propulsion/> <Segment/> <Doors>5</Doors> <Seats>5</Seats> <PersUtil>P</PersUtil> <ModelYear/> <CountryOrigin/> <Special>2</Special> <Block type="t" name="technical Car Data Block"> <RPM>3600</RPM> <Couple>270</Couple> <CoupleTMin>1750</CoupleTMin> <NumberOfCylindres>L4</NumberOfCylindres> <NumberOfValves>4</NumberOfValves> <Turbo>Y</Turbo> <Boring>75</Boring> <Stroke>88,3</Stroke> <FuelConsumptionUrban>5</FuelConsumptionUrban> <FuelConsumptionExtraUrban>3,7</FuelConsumptionExtraUrban> <FuelConsumptionExtraCombined>4,2</FuelConsumptionExtraCombined> <Co2Emission>100</Co2Emission> <Euronorm>EURO6</Euronorm> <BrakesFront>GEVENT. SCHIJVEN</BrakesFront> <BrakesBack>SCHIJVEN</BrakesBack> <TyreTypeFront>215/60 R 16 95V</TyreTypeFront> <TyreTypeBack>215/60 R 16 95V</TyreTypeBack> <Block type="m" name="measurements Car Data Block"> <MassInRunningOrder>1609</MassInRunningOrder> <MaxAllowedMass>3200</MaxAllowedMass> <Wheelbase>2815</Wheelbase> <AxleWidthFront>1576</AxleWidthFront> <AxleWidthBack>1548</AxleWidthBack> <Steering>11,9</Steering> <RideHeight>1521</RideHeight> <TrunkCapacity>560</TrunkCapacity> <TrunkCapacityFolded>1598</TrunkCapacityFolded> <TankVolume>72</TankVolume> <Length>4823</Length> 2050 Antwerpen F

6 <Width>1864</Width> <Height>1521</Height> <Block type="q" name="standard Equipment Block"> <Equipment mainsequence="a" sequence="a1"> <MainCategoryNameNL>Interieur</MainCategoryNameNL> <MainCategoryNameFR>Interieur</MainCategoryNameFR> <CategoryNameNL>Zetels</CategoryNameNL> <CategoryNameFR>Sièges</CategoryNameFR> <EquipmentNameNL>In 2 delen neerklapbare achterbank (1/3-2/3) + Isofix-systeem op de zijplaatse</equipmentnamenl> <EquipmentNameFR>Banquette arrière rabattable en 2 parties (2/3-1/3) + système Isofix sur sièges </EquipmentNameFR> <Equipment mainsequence="a" sequence="a1"> <MainCategoryNameNL>Interieur</MainCategoryNameNL> <MainCategoryNameFR>Interieur</MainCategoryNameFR> <CategoryNameNL>Zetels</CategoryNameNL> <CategoryNameFR>Sièges</CategoryNameFR> <EquipmentNameNL>Centrale armsteun voorin met opbergruimte</equipmentnamenl> <EquipmentNameFR>Accoudoir central avant avec rangement</equipmentnamefr> <Equipment mainsequence="b" sequence="b1"> <MainCategoryNameNL>Exterieur</MainCategoryNameNL> <MainCategoryNameFR>Exterieur</MainCategoryNameFR> <CategoryNameNL>Trim exterieur</categorynamenl> <CategoryNameFR>Finition extérieur</categorynamefr> <EquipmentNameNL>Metaalkleur</EquipmentNameNL> <EquipmentNameFR>Peinture métallisée</equipmentnamefr> <ConstructCode>0MM0</ConstructCode> <Equipment mainsequence="b" sequence="b2"> <MainCategoryNameNL>Exterieur</MainCategoryNameNL> <MainCategoryNameFR>Exterieur</MainCategoryNameFR> <CategoryNameNL>Verlichting exterieur</categorynamenl> <CategoryNameFR>Eclairage extérieur</categorynamefr> <EquipmentNameNL>Achterlichten met ''Peugeotsignatuur''</EquipmentNameNL> <EquipmentNameFR>Feux arrière en signature Peugeot</EquipmentNameFR> <Equipment mainsequence="c" sequence="c1"> <CategoryNameNL>Sloten</CategoryNameNL> <CategoryNameFR>Serrures</CategoryNameFR> <EquipmentNameNL>Automatische vergrendeling tijdens het rijden</equipmentnamenl> <EquipmentNameFR>Verrouillage automatique des portes en roulant</equipmentnamefr> 2050 Antwerpen F

7 <Equipment mainsequence="c" sequence="c1"> <CategoryNameNL>Sloten</CategoryNameNL> <CategoryNameFR>Serrures</CategoryNameFR> <EquipmentNameNL>Centrale deurvergrendeling met afstandsbediening</equipmentnamenl> <EquipmentNameFR>Condamnation centralisée des portes avec commande à distance</equipmentnamefr> <Equipment mainsequence="c" sequence="c1"> <CategoryNameNL>Sloten</CategoryNameNL> <CategoryNameFR>Serrures</CategoryNameFR> <EquipmentNameNL>Elektrisch kinderslot</equipmentnamenl> <EquipmentNameFR>Sécurité enfant électrique</equipmentnamefr> <Equipment mainsequence="c" sequence="c4"> <CategoryNameNL>Veiligheid aandrijving</categorynamenl> <CategoryNameFR>Sécurité traction</categorynamefr> <EquipmentNameNL>ESP + ASR Perfo + Hill Assist</EquipmentNameNL> <EquipmentNameFR>ESP + ASR Perfo + Hill Assist</EquipmentNameFR> <ConstructCode>UF01</ConstructCode> <Equipment mainsequence="c" sequence="c6"> <CategoryNameNL>Zichtbaarheid</CategoryNameNL> <CategoryNameFR>Visibilité</CategoryNameFR> <EquipmentNameNL>Elektrische en verwarmde buitenspiegels</equipmentnamenl> <EquipmentNameFR>Rétroviseurs électriques et chauffants</equipmentnamefr> <Equipment mainsequence="c" sequence="c6"> <CategoryNameNL>Zichtbaarheid</CategoryNameNL> <CategoryNameFR>Visibilité</CategoryNameFR> <EquipmentNameNL>Hindernissendetector achteraan</equipmentnamenl> <EquipmentNameFR>Détecteur d'obstacles arrière</equipmentnamefr> <ConstructCode>UB01</ConstructCode> <Equipment mainsequence="c" sequence="c6"> 2050 Antwerpen F

8 <CategoryNameNL>Zichtbaarheid</CategoryNameNL> <CategoryNameFR>Visibilité</CategoryNameFR> <EquipmentNameNL>Reglementair plaatje op de zonneklep</equipmentnamenl> <EquipmentNameFR>Plaquette réglementaire sur le paresoleil</equipmentnamefr> <ConstructCode>QJ01</ConstructCode> <Equipment mainsequence="c" sequence="c7"> <CategoryNameNL>Gordels en airbags</categorynamenl> <CategoryNameFR>Ceintures de sécurité et airbags</categorynamefr> <EquipmentNameNL>Frontale airbags, laterale airbags voorin, gordijnairbags voor- en achterin</equipmentnamenl> <EquipmentNameFR>Airbags frontaux, airbags latéraux avant, airbags rideaux avant et arrière</equipmentnamefr> <ConstructCode>NF04</ConstructCode> <Equipment mainsequence="c" sequence="c8"> <CategoryNameNL>Wettelijke kit</categorynamenl> <CategoryNameFR>Kit légal</categorynamefr> <EquipmentNameNL>Wettelijke kit : 10 liter brandstof, een verkeersdriehoek, een verbanddoosje, ee</equipmentnamenl> <EquipmentNameFR>Kit légal : 10 litres de carburant, un triangle, une trousse de secours, un exti</equipmentnamefr> <Equipment mainsequence="d" sequence="d1"> <MainCategoryNameNL>Comfort</MainCategoryNameNL> <MainCategoryNameFR>Comfort</MainCategoryNameFR> <CategoryNameNL>Audio, tv en 12v access</categorynamenl> <CategoryNameFR>Audio, tv et access</categorynamefr> <EquipmentNameNL>Peugeot Connect Sound : radio met mp3- compatibel cd-speler en bediening aan het </EquipmentNameNL> <EquipmentNameFR>Peugeot Connect Sound : radio avec lecteur CD compatible MP3 et commandes au vol</equipmentnamefr> <Equipment mainsequence="d" sequence="d1"> <MainCategoryNameNL>Comfort</MainCategoryNameNL> <MainCategoryNameFR>Comfort</MainCategoryNameFR> <CategoryNameNL>Audio, tv en 12v access</categorynamenl> <CategoryNameFR>Audio, tv et access</categorynamefr> <EquipmentNameNL>Peugeot Connect SOS: noodoproep met localiseringsfunctie + Peugeot connect nav</equipmentnamenl> <EquipmentNameFR>Peugeot Connect SOS: appel d'urgence localisé + Peugeot connect nav</equipmentnamefr> <ConstructCode>WLXX</ConstructCode> <Equipment mainsequence="g" sequence="g"> <MainCategoryNameNL>Diversen</MainCategoryNameNL> <MainCategoryNameFR>Diversen</MainCategoryNameFR> 2050 Antwerpen F

9 <CategoryNameNL>Diversen</CategoryNameNL> <CategoryNameFR>Divers</CategoryNameFR> <EquipmentNameNL>Dieselpartikelfilter (DPF)</EquipmentNameNL> <EquipmentNameFR>Filtre à particules (FAP)</EquipmentNameFR> <Block type="p" name="options and Packs Block"> <Option mainsequence="a" sequence="a1"> <MainCategoryNameNL>Interieur</MainCategoryNameNL> <MainCategoryNameFR>Interieur</MainCategoryNameFR> <CategoryNameNL>Zetels</CategoryNameNL> <CategoryNameFR>Sièges</CategoryNameFR> <OptionNameNL>Elektrisch regelbare lendensteun op bestuurderszetel</optionnamenl> <OptionNameFR>Réglage lombaire électrique siège conducteur</optionnamefr> <ConstructCode>WA52</ConstructCode> <OptionPrice unit="eur" VAT="excl">165,29</OptionPrice> </Option> <Option mainsequence="b" sequence="b2"> <MainCategoryNameNL>Exterieur</MainCategoryNameNL> <MainCategoryNameFR>Exterieur</MainCategoryNameFR> <CategoryNameNL>Verlichting exterieur</categorynamenl> <CategoryNameFR>Eclairage extérieur</categorynamefr> <OptionNameNL>Mistlampen vooraan met LED</OptionNameNL> <OptionNameFR>Feux anti-brouillard avant avec LED</OptionNameFR> <ConstructCode>PR01</ConstructCode> <OptionPrice unit="eur" VAT="excl">165,29</OptionPrice> </Option> <Option mainsequence="e" sequence="e1"> <MainCategoryNameNL>Lading</MainCategoryNameNL> <MainCategoryNameFR>Lading</MainCategoryNameFR> <CategoryNameNL>Koffer</CategoryNameNL> <CategoryNameFR>Coffre</CategoryNameFR> <OptionNameNL>Bagagenet</OptionNameNL> <OptionNameFR>Filet d'arrêt de charge</optionnamefr> <ConstructCode>NM01</ConstructCode> <OptionPrice unit="eur" VAT="excl">123,97</OptionPrice> </Option> </Cardata> 2050 Antwerpen F