Autoconnect CARWIZARD REST API voor gangbare Belgische voertuiggegevens

Transcriptie

1 Autoconnect CARWIZARD REST API voor gangbare Belgische voertuiggegevens Versie: juni 2016 In dit document vindt u een beknopte handleiding voor de REST service voor gangbare Belgische voertuiggegevens. Deze REST API bevat gegevens van NIEUWE voertuigen (personenwagens en lichte vrachtwagens) die momenteel op de Belgische markt te koop zijn. Voor gegevens van niet meer gangbare voertuigen (uit het verleden), verwijzen we naar de aparte documentatie van die dienst. Om de dienst te gebruiken, heb je een API-key nodig. Op basis van die key zal het gebruik gemeten worden. De dienst wordt aangeboden volgens een transactie-gebaseerd model. Enkel het ophalen van de versieslijst en van de details van een versie (met prijs) zijn te betalen. Het ophalen van merkenlijst en modellenlijst niet. 1. Ophalen van merken: 2. Ophalen van modellen onder een merk: In dit voorbeeld is het merk-id: 47, Peugeot. 3. Ophalen van versies onder een model: In dit voorbeeld is het model: Ophalen van voertuigdetails per versie: In dit voorbeeld is de versie: De GTMQPF duidt op de gegevensblokken die worden gevraagd. De volgende blokken zijn beschikbaar: G: General Car Data T: Technical Car Data M: Measurements Car Data Q: Standard Equipment P: Options and Packs F: Financial Data (catalogusprijs) De inhoud van deze blokken kunt u verderop in dit document lezen. Wenst u een test-api-key te ontvangen voor een beperkt aantal raadplegingen? Contacteer ons dan aub. 1

2 De voorbeelden van deze antwoord volgende XML op: opvragingen leveren als 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> <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"> 2

3 <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 3

4 </Request> <Versionlist> <Version versionid=" "> <Versionname>BlueHDI Business Line</Versionname> <PowerHp unit="hp">115</powerhp> <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> <PowerHp unit="hp">116</powerhp> <Fueltype>BENZINE</Fueltype> <Bodyworktype>Break</Bodyworktype> <Version versionid=" "> <Versionname>VTI Active BMP</Versionname> <PowerHp unit="hp">116</powerhp> <Fueltype>BENZINE</Fueltype> <Bodyworktype>Break</Bodyworktype> <Version versionid=" "> <Versionname>THP Active AUT SST (EU6)</Versionname> <PowerHp unit="hp">165</powerhp> <Fueltype>BENZINE</Fueltype> <Bodyworktype>Break</Bodyworktype> </Versionlist> </Cardata> 4

5 4. Ophalen van voertuigdetails: In dit voorbeeld is de versie: en de gevraagde blokken zijn GTMQP: <?xml version="1.0" encoding="utf-8"?> <Cardata> <Request> <Language>NL</Language> <MemberId>6</MemberId> <MemberName>Impact Software Admin</MemberName> <Make makeid="42">mercedes</make> <Model modelid="4593">a-klasse <Version verid=" ">a180 CDI Urban </Request> <Block type="g" name="general Car Data Block"> <Versionname>A180 CDI Urban</Versionname> <Bodyworktype>Hatchback</Bodyworktype> <Fueltype>DIESEL</Fueltype> <CilindercontentL unit="liter">1.5</cilindercontentl> <TotalCylinderCapacity unit="cm3">1461</totalcylindercapacity> <MaxNetPowerkW unit="kw">80</maxnetpowerkw> <MaxNetPowerHp unit="hp">109</maxnetpowerhp> <TaxableHp>8</TaxableHp> <ConstructCode></ConstructCode> <GearBox>5 MAN</GearBox> <Propulsion>VOORWIELAANDRIJVING</Propulsion> <Segment>C</Segment> <NumberOfSeats>5</NumberOfSeats> <PersUtil>P</PersUtil> <ModelYear>2013</ModelYear> <CountryOrigin>D</CountryOrigin> <Special>2</Special> <Block type="t" name="technical Car Data Block"> <RPM>4000</RPM> <Couple>260</Couple> 5

6 <CoupleTMin>1750</CoupleTMin> <NumberOfCylindres>L4</NumberOfCylindres> <NumberOfValves>4</NumberOfValves> <Turbo>Y</Turbo> <Boring>0</Boring> <Stroke>0</Stroke> <FuelConsumptionUrban>4,5</FuelConsumptionUrban> <FuelConsumptionExtraUrban>3,3</FuelConsumptionExtraUrban> <FuelConsumptionExtraCombined>3,8</FuelConsumptionExtraCombined> <CO2Combined unit="g/km">98</co2combined> <Euronorm>EURO5</Euronorm> <BrakesFront>GEVENT. SCHIJVEN</BrakesFront> <BrakesBack>SCHIJVEN</BrakesBack> <TyreTypeFront>225/45 R 17 91W</TyreTypeFront> <TyreTypeBack>225/45 R 17 91W</TyreTypeBack> <Block type="m" name="measurements Car Data Block"> <MassInRunningOrder>1395</MassInRunningOrder> <MaxAllowedMass>1960</MaxAllowedMass> <Wheelbase>2699</Wheelbase> <AxleWidthFront>0</AxleWidthFront> <AxleWidthBack>0</AxleWidthBack> <Steering>11</Steering> <RideHeight>0</RideHeight> <TrunkCapacity>0</TrunkCapacity> <TrunkCapacityFolded>0</TrunkCapacityFolded> <TankVolume>50</TankVolume> <Length>4292</Length> <Width>2022</Width> <Height>1433</Height> <Block type="f" name="financial Data Block"> <CatalogPrice unit="eur" VAT="excl">22775,00</CatalogPrice> <Block type="q" name="standard Equipment Block"> <Equipment mainsequence="a" sequence="a1"> <EquipmentNameNL>Achterbank neerklapbaar in 1 deel of 1/3-2/3</EquipmentNameNL> <EquipmentNameFR>Banquette AR rabattable entièrement ainsi que 1/3-2/3</EquipmentNameFR> 6

7 <ConstructCode></ConstructCode> </Equipment> <Equipment mainsequence="a" sequence="a1"> <EquipmentNameNL>Centrale armsteun VR met opbergvak </EquipmentNameNL> <EquipmentNameFR>Accoudoir central AV avec vide-poches </EquipmentNameFR> <ConstructCode></ConstructCode> </Equipment> <Equipment mainsequence="a" sequence="a1"> <EquipmentNameNL>Centrale armsteun vooraan verstelbaar in lengterichting en met siernaden</equipmentnamenl> <EquipmentNameFR>Accoudoir de console centrale avec surpiqûres, réglable en approche</equipmentnamefr> <ConstructCode></ConstructCode> </Equipment> <Equipment mainsequence="g" sequence="g"> <MainCategoryNameNL>Diversen</MainCategoryNameNL> <MainCategoryNameFR>Diversen</MainCategoryNameFR> <CategoryNameNL>Diversen</CategoryNameNL> <CategoryNameFR>Divers</CategoryNameFR> <EquipmentNameNL>Dieselpartikelfilter</EquipmentNameNL> <EquipmentNameFR>Filtre à particules</equipmentnamefr> <ConstructCode>KA1</ConstructCode> </Equipment> <Block type="p" name="options and Packs Block"> <Option mainsequence="a" sequence="a1"> 7

8 <OptionNameNL>Neerklapbare armleuning achteraan, uitneembaar</optionnamenl> <OptionNameFR>Accoudoir AR central escamotable, amovible</optionnamefr> <ConstructCode>400</ConstructCode> <OptionPrice unit="eur" VAT="excl">165,00</OptionPrice> <OptionInfoNL></OptionInfoNL> <OptionInfoFR></OptionInfoFR> </Option> <Option mainsequence="a" sequence="a1"> <OptionNameNL>Elektrisch verstelbare bestuurderszetel, stuurkolom en buitenspiegel bestuurder,</optionnamenl> <OptionNameFR>Siège conducteur, colonne de direction et rétroviseurs extérieurs à réglage élec</optionnamefr> <ConstructCode>275</ConstructCode> <OptionPrice unit="eur" VAT="excl">315,00</OptionPrice> <OptionInfoNL></OptionInfoNL> <OptionInfoFR></OptionInfoFR> </Option> <Option mainsequence="a" sequence="a1"> <OptionNameNL>Elektrisch verstelbare voorzetels Memory</OptionNameNL> <OptionNameFR>Siège AV à réglage électrique avec mémoire</optionnamefr> <ConstructCode>242</ConstructCode> <OptionPrice unit="eur" VAT="excl">260,00</OptionPrice> <OptionInfoNL>Enkel icm 275</OptionInfoNL> <OptionInfoFR>Seulement eca 275</OptionInfoFR> </Option> <Option mainsequence="g" sequence="g"> <MainCategoryNameNL>Diversen</MainCategoryNameNL> <MainCategoryNameFR>Diversen</MainCategoryNameFR> 8

9 <CategoryNameNL>Diversen</CategoryNameNL> <CategoryNameFR>Divers</CategoryNameFR> <OptionNameNL>Presafe</OptionNameNL> <OptionNameFR>Presafe</OptionNameFR> <ConstructCode>299</ConstructCode> <OptionPrice unit="eur" VAT="excl">330,00</OptionPrice> <OptionInfoNL></OptionInfoNL> <OptionInfoFR></OptionInfoFR> </Option> </Cardata> inmotiv/bd/ /eod 9