Main Page

From Car and Driving
Jump to: navigation, search

Contents

Welcome

This wiki describes how to access the Car and Driving editorial and video data through our webservice.


An Example Site

You can see an example site, here - www.caranddriving.com - contact info@caranddriving.com for a login, or simply use the 'Try Our Public Site' option to enter the main site as a demo user.

This site showcases all our data, and is driven completely by the webservice - all data on show here is accessible from the webservice.


What Videos Are Available

You can see our current new car videos here: http://www.caranddriving.com/cdadmin/info.aspx

Our list of used car videos (i.e. videos of models no longer in production)here: http://www.caranddriving.com/cdadmin/infoused.aspx

For a list of which videos we have recently added to our library, please see here: http://www.caranddriving.com/cdadmin/inforecent.aspx


Recommended Approaches

There are three ways of integrating our data and videos on your site:

- Searching the Webservice - We have a fully functional webservice that can be integrated into your site. Videos are displayed using The Video Player in an iframe.

- The Helper Page - If your website does not support webservice integration, we have a 'helper' page which provides much of the functionality of webservice powered sites, and which can be controlled by querystrings passed to it.

- Adding Videos to Blogs and News Pages - If you want to put our videos on a blog, or similar content management driven website, they can be embedded in a similar way that you might embed a youtube video. GForces and Wordpress sites are supported, as are general content management systems - in general, if you can embed a youtube video, you will be able to embed our video.

Please do not try and call the video player directly without either getting a recent URL from the webservice, or using the helper page.

In all cases, we need to setup an account for you and give you a user_id; please let us know your needs and we'll get you setup. For webservice integration (only) we need to know the IP address of any server calling our webservice when setting up your account; for the other methods, we don't need to know that - just tell us that you want to use our helper page or embed code.

The Webservice

Our main webservice can be reached at:

or

The two webservices are the same, but will return slightly different paths to videos and photos - in particular the https: version is careful to ensure all url's it returns are https: links (and so won't give errors if used on sites running under https).

A041 is the version number; this changes with each new release, keeping the previous version of the webservice intact. In this way, current users can be confident the webservice won't change unexpectedly as it is upgraded - simply point your application to the new webservice when you are ready to upgrade.

The webservice is protected by a user_id that is unique to each user, and can be locked to an IP Address or a range of them. You must quote your user_id on every webservice call, or you will receive a 'IP address not authorised' error.

If you visit the webservice in a web browser, you will get a list of all the available functions, together with a set of test forms that you can use to try out your searches.

Please read Searching the Webservice for more detail, and The Video Player for details on how the video's appearance can be customised. The Helper Page and Adding Videos to Blogs and News Pages document an alternative way of using the webservice that allows embedding videos on blogs or static pages.

Read More

Personal tools