Autoconnect CARWIZARD REST API voor historische Belgische voertuiggegevens

Transcriptie

1 Autoconnect CARWIZARD REST API voor historische Belgische voertuiggegevens Versie: juni 2016 In dit document vindt u een beknopte handleiding voor de REST service voor historische Belgische voertuiggegevens. Deze REST API bevat gegevens van voertuigen (personenwagens en lichte vrachtwagens) die in het verleden én momenteel op de Belgische markt te koop zijn geweest of nog zijn. 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. De basis-url is: Daarna komen de afdelingen "makes", "models", "versions" en tenslotte "versiondetail". Daarna de API key. Daarna een zg. peildatum. Er is nu 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. Na de peildatum komt het nummer van merk, model of versie waar je dieper in duikt. Bij het versiedetail komt nog een opsomming van de gegevensblokken die worden gevraagd. Voorbeelden van queries: Merken op 01/01/2009: Modellen van het merk met merk-id 47 op 01/01/2009: Versies van het model met model-id 3279 op 01/01/2009: Detail van een versie met versie-id op 01/01/2009: 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. 1

2 Wenst u een test-api-key te ontvangen voor een beperkt aantal raadplegingen? Contacteer ons dan aub. De voorbeelden van deze opvragingen leveren als antwoord volgende XML op: 1. Ophalen van merken: <Makelist> <Make makeid="88">abarth</make> <Make makeid="1">alfa ROMEO</Make> <Make makeid="3">asia</make> <Make makeid="4">aston MARTIN</Make> <Make makeid="5">audi</make> <Make makeid="7">bentley</make> <Make makeid="8">bmw</make> <Make makeid="105">bmw ALPINA</Make> <Make makeid="11">cadillac</make> <Make makeid="13">chevrolet</make> <Make makeid="14">chrysler</make> <Make makeid="15">citroen</make> <Make makeid="112">corvette</make> <Make makeid="111">dacia</make> <Make makeid="16">daewoo</make> <Make makeid="17">daihatsu</make> </Makelist> 2. Ophalen van modellen onder een merk: In dit voorbeeld is het merk-id: 47, Peugeot. <Make makeid="47">peugeot</make> <Modellist> <Model modelid="3991"> <Model modelid="4194"> <Modelname>308</Modelname> <Category categoryid="2">berline</category> <Segment segmentid="3">c</segment> <Model modelid="3423"> <Modelname>407</Modelname> <Category categoryid="2">berline</category> <Segment segmentid="4">d</segment> 2

3 <Model modelid="3279"> <Modelname>607</Modelname> <Category categoryid="2">berline</category> <Segment segmentid="5">h1</segment> <Model modelid="4197"> <Modelname>4007</Modelname> <Category categoryid="9">suv</category> <Segment segmentid="7">4 x 4</Segment> <Model modelid="3283"> <Modelname>307 Break</Modelname> <Category categoryid="3">break</category> <Segment segmentid="10">break</segment> <Model modelid="3929"> <Modelname>407 SW</Modelname> <Category categoryid="3">break</category> <Segment segmentid="10">break</segment> <Model modelid="4137"> <Modelname>207 CC</Modelname> <Category categoryid="6">cabrio</category> <Segment segmentid="12">cabrio</segment> <Model modelid="4272"> <Modelname>Partner</Modelname> <Category categoryid="11">utilitair voertuig</category> <Segment segmentid="13">utilitair</segment> </Modellist> 3. Ophalen van versies onder een model: In dit voorbeeld is het model: 3279 <Make makeid="47">peugeot</make> <Model modelid="3279">607 <Versionlist> <Version versionid="78397"> <Versionname>HDi Ivoire FAP</Versionname> <Numberofdoors>4</Numberofdoors> <CilindercontentL unit="liter">2.0</cilindercontentl> <PowerHp unit="hp">136</powerhp> <Version versionid="78381"> <Versionname>HDi Titane FAP</Versionname> 3

4 <Numberofdoors>4</Numberofdoors> <CilindercontentL unit="liter">2.0</cilindercontentl> <PowerHp unit="hp">136</powerhp> <Version versionid="78394"> <Versionname>HDi Ivoire FAP Aut.</Versionname> <Numberofdoors>4</Numberofdoors> <CilindercontentL unit="liter">2.7</cilindercontentl> <PowerHp unit="hp">204</powerhp> <Version versionid="78385"> <Versionname>HDi Titane FAP Aut.</Versionname> <Numberofdoors>4</Numberofdoors> <CilindercontentL unit="liter">2.7</cilindercontentl> <PowerHp unit="hp">204</powerhp> </Versionlist> 4. Ophalen van voertuigdetails: In dit voorbeeld is de versie: en de gevraagde blokken zijn GTMPQF: <?xml version="1.0" encoding="utf-8"?> <Make makeid="42">mercedes</make> <Model modelid="4593">a-klasse <Version verid=" ">a180 CDI Urban <Block type="g" name="general Car Data Block"> <Versionname>A180 CDI Urban</Versionname> <Bodyworktype>Hatchback</Bodyworktype> <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> <Numberofdoors>5</Numberofdoors> <NumberOfSeats>5</NumberOfSeats> <PersUtil>P</PersUtil> 4

5 <ModelYear>2013</ModelYear> <CountryOrigin>D</CountryOrigin> <Special>2</Special> <Block type="t" name="technical Car Data Block"> <RPM>4000</RPM> <Couple>260</Couple> <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>ISOFIX-verankeringspunten</EquipmentNameNL> <EquipmentNameFR>Points d ancrage ISOFIX </EquipmentNameFR> <ConstructCode>SD0</ConstructCode> <Equipment mainsequence="a" sequence="a1"> 5

6 <EquipmentNameNL>Sportzetels vooraan</equipmentnamenl> <EquipmentNameFR>Sièges AV sport</equipmentnamefr> <ConstructCode>244</ConstructCode> <Equipment mainsequence="a" sequence="a1"> <EquipmentNameNL>Centrale armsteun VR met opbergvak </EquipmentNameNL> <EquipmentNameFR>Accoudoir central AV avec vide-poches </EquipmentNameFR> <ConstructCode></ConstructCode> <Equipment mainsequence="g" sequence="g"> <MainCategoryNameNL>Diversen</MainCategoryNameNL> <MainCategoryNameFR>Diversen</MainCategoryNameFR> <CategoryNameNL>Diversen</CategoryNameNL> <CategoryNameFR>Divers</CategoryNameFR> <EquipmentNameNL>ECO start/stop</equipmentnamenl> <EquipmentNameFR>ECO start/stop</equipmentnamefr> <ConstructCode></ConstructCode> <Block type="p" name="options and Packs Block"> <Option mainsequence="a" sequence="a1"> <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 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> 6

7 <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 mainsequence="g" sequence="g"> <MainCategoryNameNL>Diversen</MainCategoryNameNL> <MainCategoryNameFR>Diversen</MainCategoryNameFR> <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> inmotiv/bd/311215/eod 7