There are several web services used to create Jauntlets, and you are free to use them in your own applications. They use simple REST protocols, where an http get request with query string parameters returns an XML file. The services are limited to IP addresses, so if you want to use them, email info@jauntlet.com and tell me your IP and what youre doing.

The Journey service takes a Journey ID and returns the information for the journey. For now, you just have to provide the ID yourself, which you get from the query string of your Jauntlets. In the future, there should be a service to get ID from other information.

URL: http://www.jauntlet.com/xmljourney.aspx?id=123

• The id is the Journey ID.
• If there is an error, there will just be an empty journey element.
• The dates are formatted for the JavaScript new Date constructor.
• Some elements may be empty.
• The photo url is to an image with its longest side 240 pixels.
• Flickr's terms of use requires you to link the photo to its page.

<?xml version="1.0"?> <journey> <jaunterid>1</jaunterid> <journeytitle>Sample Journey</journeytitle> <journeydescription>This is a sample for APIs.</journeydescription> <destinations> <destination> <id>1186</id> <startdate>October 1, 2006</startdate> <enddate>October 5, 2006</enddate> <country>United States</country> <region>Massachusetts</region> <city>Boston</city> <latitude>42.35</latitude> <longitude>-71.05</longitude> <destinationdescription>Visiting Boston.</destinationdescription> <photos></photos> </destination> <destination> <id>1187</id> <startdate>October 5, 2006</startdate> <enddate>October 10, 2006</enddate> <country>France</country> <region></region> <city>Paris</city> <latitude>48.86</latitude> <longitude>2.33</longitude> <destinationdescription>Off to Paris.</destinationdescription> <photos> <photo> <url>http://static.flickr.com/50/226486896_30b70eccff_m.jpg</url> <page>http://www.flickr.com/photos/47058503995@N01/226486896/</page> <title>Notre Dame</title> </photo> <photo> <url>http://static.flickr.com/50/226486894_0f4bebd234_m.jpg</url> <page>http://www.flickr.com/photos/47058503995@N01/226486894/</page> <title>Eiffel Tower</title> </photo> </photos> </destination> </destinations> </journey>

Because JavaScript can only connect to the server whence it came and because you must have a single IP, you need to use a server proxy to connect to the Jauntlet services.

<%@ Page Language="C#" ContentType="text/xml" %> <%@ Import Namespace="System.Net" %> <% WebClient wc = new WebClient(); wc.Encoding = Encoding.UTF8; string resp = wc.DownloadString(Url.Text); Response.Write(resp); %>

This is a sample of a client-side JavaScript call to the Journey service through the proxy above.

function getXMLDoc() { var x = false; if(window.XMLHttpRequest) { try { x = new XMLHttpRequest(); x.overrideMimeType("text/xml"); } catch(e) { } } else if(window.ActiveXObject) { try { x = new ActiveXObject("Microsoft.XMLHTTP"); } catch(e) { try { x = new ActiveXObject("Msxml2.XMLHTTP"); } catch(e) { } } } return x; } function loaddoc() { try { if (xmldoc.readyState == 4) { if (xmldoc.status == 200) { // Do processing here. } } } catch(e) { } } var xmldoc = getXMLDoc(); var url = "http://www.myserver.com/proxy.aspx?url="+encodeURIComponent("http://www.jauntlet.com/xmljourney.aspx?id=315"); if(xmldoc) { xmldoc.onreadystatechange = loaddoc; xmldoc.open("GET", url, true); xmldoc.send(null); }

If you use Jauntlet APIs on your site please include the logo below or the text "Powered by Jauntlet" linked to http://www.jauntlet.com.