Autoconnect CARWIZARD REST API voor historische Belgische voertuiggegevens

Transcriptie

1 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: Antwerpen F inmotiv.be

2 Ophalen van modellen onder een merk: Ophalen van versies onder een model: Ophalen van voertuigdetails: 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: <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> 2050 Antwerpen F

3 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> <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> 2050 Antwerpen F

4 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> <CilindercontentL unit="liter">2.0</cilindercontentl> <PowerHp unit="hp">136</powerhp> <Version versionid="78381"> <Versionname>HDi Titane FAP</Versionname> <CilindercontentL unit="liter">2.0</cilindercontentl> <PowerHp unit="hp">136</powerhp> <Version versionid="78394"> <Versionname>HDi Ivoire FAP Aut.</Versionname> <CilindercontentL unit="liter">2.7</cilindercontentl> <PowerHp unit="hp">204</powerhp> <Version versionid="78385"> <Versionname>HDi Titane FAP Aut.</Versionname> <CilindercontentL unit="liter">2.7</cilindercontentl> <PowerHp unit="hp">204</powerhp> </Versionlist> 2050 Antwerpen F

5 4. Ophalen van voertuigdetails: In dit voorbeeld is de versie: en vragen we het blok GTMQP op: (uittreksel, herhalingen zijn niet volledig opgenomen) <?xml version="1.0" encoding="utf-8"?> <Make makeid=""></make> <Model modelid=""> <Version verid="78381">hdi Titane FAP <Block type="i" name="basic Insurance Block"> <Makename>PEUGEOT</Makename> <Modelname></Modelname> <MaxNetPowerkW unit="kw">100</maxnetpowerkw> <MaxNetPowerHp unit="hp">136</maxnetpowerhp> <FuelType>DIESEL</FuelType> <CO2Combined unit="g/km">160</co2combined> <NumberOfSeats>5</NumberOfSeats> <BodyworkType>Sedan</BodyworkType> <TotalCylinderCapacity unit="cm3">1997</totalcylindercapacity> <CatalogPrice unit="eur" VAT="excl">33 438,02</CatalogPrice> <Block type="g" name="general Car Data Block"> <Versionname></Versionname> <TaxableHp>11</TaxableHp> <ConstructCode>Z9A4V7D601A07</ConstructCode> <VersionID>78381</VersionID> <GearBox></GearBox> <Propulsion>VOORWIELAANDRIJVING</Propulsion> <Segment></Segment> <Doors>4</Doors> <Seats>5</Seats> <PersUtil>P</PersUtil> <ModelYear></ModelYear> <CountryOrigin></CountryOrigin> <Special>2</Special> <Block type="t" name="technical Car Data Block"> <RPM>4000</RPM> <Couple>320</Couple> <CoupleTMin>2000</CoupleTMin> <NumberOfCylindres>L4</NumberOfCylindres> <NumberOfValves>4</NumberOfValves> <Turbo>Y</Turbo> <Boring>85</Boring> <Stroke>88</Stroke> <FuelConsumptionUrban>8,1</FuelConsumptionUrban> <FuelConsumptionExtraUrban>5</FuelConsumptionExtraUrban> <FuelConsumptionExtraCombined>6,1</FuelConsumptionExtraCombined> <Co2Emission>160</Co2Emission> 2050 Antwerpen F

6 <Euronorm>EURO4</Euronorm> <BrakesFront>GEVENT. SCHIJVEN</BrakesFront> <BrakesBack>SCHIJVEN</BrakesBack> <TyreTypeFront>225/50 R 17 W</TyreTypeFront> <TyreTypeBack>225/50 R 17 W</TyreTypeBack> <Block type="m" name="measurements Car Data Block"> <MassInRunningOrder>1665</MassInRunningOrder> <MaxAllowedMass>2083</MaxAllowedMass> <Wheelbase>2800</Wheelbase> <AxleWidthFront>1528</AxleWidthFront> <AxleWidthBack>1529</AxleWidthBack> <Steering>11</Steering> <RideHeight>140</RideHeight> <TrunkCapacity>468</TrunkCapacity> <TrunkCapacityFolded>468</TrunkCapacityFolded> <TankVolume>80</TankVolume> <Length>4902</Length> <Width>1835</Width> <Height>1442</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>Centrale armsteun AR</EquipmentNameNL> <EquipmentNameFR>Accoudoir centrale AR</EquipmentNameFR> <ConstructCode></ConstructCode> <Equipment mainsequence="a" sequence="a1"> <MainCategoryNameNL>Interieur</MainCategoryNameNL> <MainCategoryNameFR>Interieur</MainCategoryNameFR> <CategoryNameNL>Zetels</CategoryNameNL> <CategoryNameFR>Sièges</CategoryNameFR> <EquipmentNameNL>Verwarmde zetels VR/AR</EquipmentNameNL> <EquipmentNameFR>Sièges chauffants AV/AR</EquipmentNameFR> <ConstructCode>NA04</ConstructCode> <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> 2050 Antwerpen F

7 <EquipmentNameNL>Mistkoplampen VR</EquipmentNameNL> <EquipmentNameFR>Phares antibrouillards AV</EquipmentNameFR> <ConstructCode>PR01</ConstructCode> <Block type="p" name="options and Packs Block"> <Option mainsequence="a" sequence="a6"> <MainCategoryNameNL>Interieur</MainCategoryNameNL> <MainCategoryNameFR>Interieur</MainCategoryNameFR> <CategoryNameNL>Open dak</categorynamenl> <CategoryNameFR>Toit ouvrant</categorynamefr> <OptionNameNL>Elektrisch bediend schuifdak</optionnamenl> <OptionNameFR>Toit ouvrant à commande électrique</optionnamefr> <ConstructCode>TC07</ConstructCode> <OptionPrice unit="eur" VAT="excl">743,80</OptionPrice> </Option> <Option mainsequence="c" sequence="c6"> <MainCategoryNameNL>Veiligheid</MainCategoryNameNL> <MainCategoryNameFR>Veiligheid</MainCategoryNameFR> <CategoryNameNL>Zichtbaarheid</CategoryNameNL> <CategoryNameFR>Visibilité</CategoryNameFR> <OptionNameNL>Detector voor hindernissen VR + koplampsproeiers</optionnamenl> <OptionNameFR>Détecteur d obstacles AV + laveprojecteurs</optionnamefr> <ConstructCode>UB03</ConstructCode> <OptionPrice unit="eur" VAT="excl">247,93</OptionPrice> </Option> 2050 Antwerpen F