Vehicle Web Services

Top  Previous  Next

Web Service for Web Site Developers

 

Introduction

 

Web sites can gain access to Vehicle Stock in Navigator using a standardised web service call.  This web service will retrieve a formatted data feed on demand.    

There is a companion web service which provides access to Vehicle images.

A Web Developer will need to poll the Web service at regular intervals to download the latest stock and update images as and when necessary.

It should be noted that the web services should be used to update and internal Web site database with Vehicle stock and images and that these web services should not be used on the live web site interactively (they are not designed to perform  for this use).

Ideally, a web site should not refresh more than once per hour.

Data Formats

The Web service can return data in one of three formats :-

XML – a formatted XML document

JSON – a formatted JSON document

HTML- more of use to visualise the data returned rather than use for import.

API Key

To use the web service, the web designer will need to request (via their customer) a unique API key which will allow access to the web service.      

URLS

 

The main web service for the stock feed is :-

For XML Data

https://services.dmservices.co.uk/DmsNavigator.NavigatorWebService.svc/GetNavigatorReport/[apikey],1,XML_VEHICLE_STOCK_LIST,xml,1,WEB,,1,1

For JSON Data

https://services.dmservices.co.uk/DmsNavigator.NavigatorWebService.svc/GetNavigatorReport/[apikey],1,XML_VEHICLE_STOCK_LIST,json,1,WEB,,1,1

For html Data

https://services.dmservices.co.uk/DmsNavigator.NavigatorWebService.svc/GetNavigatorReport/[apikey],1,XML_VEHICLE_STOCK_LIST,html,1,WEB,,1,1

Where the [apikey] is substituted with the API key supplied as above.

Images

The web feed provides a list of image names – multiple images are available on each vehicle with image names of stockno_nn.jpg where nn starts at 0 and can increase to an unlimited no. eg 1234_0.jpg, 1234_1.jpg

To retrieve an image the following URL should be used :-

https://services.dmservices.co.uk/DmsNavigator.NavigatorWebService.svc/GetImage/[API KEY],1,[filename]

 

where the apikey is the same API Key as in the main web service and the imagefile is the filename of the image (which is in the main feed)

Example

Some sample data provided from the feed is as below :-

<x:reports xmlns:x="urn:reports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:reports http://software.dmservices.co.uk/xsd/DD09D859.xsd">

<report>

<stock>2133</stock>

<reg>NJ62YWO</reg>

<make>Nissan</make>

<model>Note</model>

<specification>N-Tec+ Dci 1461 Diesel Manual 5 Gears Mpv 2012 </specification>

<derivative>N-Tec+ Dci</derivative>

<enginesize>1461</enginesize>

<enginetype>Diesel</enginetype>

<transmission>Manual 5 Gears</transmission>

<specification10>N-Tec+ Dci 1461 Diesel Manual 5 Gears Mpv 2012 </specification10>

<colour>Blue</colour>

<year>2012</year>

<mileage>51559</mileage>

<commercial>0</commercial>

<type>Used</type>

<image>0</image>

<retail>0.00</retail>

<webprice/>

<imagelist/>

<longattentiongrabber/>

<shortattentiongrabber/>

<subheading/>

<advertisingnotes/>

<managercomments/>

<options> NJ62YWO 1 0 125500</options>

<featuresupgraded>18315</featuresupgraded>

<previousprice/>

<guideretail/>

<advertisingvehiclecategory/>

<taxband>110</taxband>

<insurancegroup/>

<origin/>

<specialoffer/>

<exdemo/>

<hpichecked/>

<cardatachecked/>

<preregistered/>

<deliverycostincl/>

<taxincluded/>

<franchiseapproved/>

<dealerapproved/>

<regfeeincluded/>

<availableforsale>1</availableforsale>

<advertiseonownwebsite>1</advertiseonownwebsite>

</report>

<report>

<stock>2400</stock>

<reg>PX68LMF</reg>

<make>Renault</make>

<model>Clio</model>

<specification>

Iconic 90 Tce 0.9 Petrol Manual 5 Door Hatchback 2018

</specification>

<derivative>Iconic 90 TCE</derivative>

<enginesize>0.9</enginesize>

<enginetype>Petrol</enginetype>

<transmission>Manual</transmission>

<specification10>

Iconic 90 Tce 0.9 Petrol Manual 5 Door Hatchback 2018

</specification10>

<colour>Iron Blue</colour>

<year>2018</year>

<mileage>2707</mileage>

<commercial>0</commercial>

<type>Used</type>

<image>0</image>

<retail>12695.00</retail>

<webprice/>

<imagelist/>

<longattentiongrabber/>

<shortattentiongrabber/>

<subheading>1 former keeper</subheading>

<advertisingnotes/>

<managercomments/>

<options/>

<featuresupgraded/>

<previousprice/>

<guideretail/>

<advertisingvehiclecategory/>

<taxband>113</taxband>

<insurancegroup/>

<origin>1</origin>

<specialoffer/>

<exdemo/>

<hpichecked/>

<cardatachecked/>

<preregistered/>

<deliverycostincl/>

<taxincluded/>

<franchiseapproved/>

<dealerapproved/>

<regfeeincluded/>

<availableforsale>1</availableforsale>

<advertiseonownwebsite>1</advertiseonownwebsite>

</report>

 

Extending or Updating the Feed

The web service feed can be updated  - with fields added or removed.  If this is required then please contact Navigator to do this.  A small consultancy fee to amend this will be made.