API Description: Retrieve full tour details (including itinerary, images, videos etc..) by its Unique ID
API URL: https://www.gotravelmanager.com/TravelManager/API/Tour/tourDetail.php?record={$tourid}&appid={$appid}&token={$token}
Variables in the URL:
* tourid : id of the tour
* appid : your application id. it is used to determine your preveleges with the APIs and also to log all your API activities into the DB
* token : to validate if you are the owner of the appid
Example Calling the API:
https://www.gotravelmanager.com/TravelManager/API/Tour/tourDetail.php?record=$record&appid=$appid&token=$token
HTTP Method: GET
Example – Response Code 701 (Authentication Failed)
<?xml version=”1.0″ encoding=”UTF-8″?>
<rsp stat=”invalid” code=”701″ created-at=”2009-06-26T09:41:14+01:00″>
<errorMessage>Authentication Failed</errorMessage>
</rsp>
Example – Response Code 703 (Tour Not Found)
<?xml version=”1.0″ encoding=”UTF-8″?>
<rsp stat=”invalid” code=”703″ created-at=”2009-06-26T09:38:42+01:00″>
<errorMessage>Tour Not Found</errorMessage>
</rsp>
Example – Response Code 700 (Successful)
<?xml version=”1.0″ encoding=”UTF-8″?>
<rsp stat=”valid” code=”700″ created-at=”2009-06-26T09:20:43+01:00″> /* code 700: successfully retrieved tour details; created-at: ISO 8601 date */
<tour>
<id>1088</id> /* ID of the tour */
<name>PARIS DAY TRIP</name> /* Name of the tour */
<reference>PA938K3</reference> /* Reference number of the tour */
<duration>1</duration> /* Number of days of the tour */
<type>Holiday & Tour</type> /* The type of the tour */
<status>Open</status> /* The status of the tour; {‘Open’, } */
<destination>Paris</destination> /* Tour Destination */
<overview><p><strong>This is a <em>good </em>Tour<
;/strong></p></overview> /* Tour overview (Rich Text) */
<highlights><p>This is a <em><strong>good </strong><
;/em><span style=\"\\\"><span style=\"\\\">Tour</span></span
></p></highlights> /* Tour highlights (Rich Text) */
<startDate>2009-04-30</startDate> /* Tour start date */
<startTime>06:00:00</startTime> /* Tour start time */
<endDate>2009-05-01</endDate> /* Tour end date */
<endTime>06:00:00</endTime> /* Tour end time */
<currency>$</currency> /* Currency for the prices */
<priceSingle>260</priceSingle> /* Price for single ticket */
<priceDouble>220</priceDouble> /* Price for double ticket */
<priceTriple>240</priceTriple> /* Price for Triple */
<priceQuad>190</priceQuad> /* Price for Quad */
/* Itinerary Items (Ordered by Day Number) */
<itinerary>
<order>Day 1</order>
<title>Day Event</title>
<description>Visit a day care center</description>
</itinerary>
<itinerary>
<order>Night 1</order>
<title>Hotel Event</title>
<description>Eat!</description>
</itinerary>
/* Images Items (Hosted on Amazon S3) */
<image>
<url>http://s3.amazonaws.com/tmDms/OWFpbWFnZXMuanBn</url>
<name>Paris Tour 1</name>
<description>this is the first image</description>
</image>
<image>
<url>http://s3.amazonaws.com/tmDms/MGJpbWFnZXMyLmpwZw==</url>
<name>Tour image 2</name>
<description>this is the second image</description>
</image>
/* Video Items (Hosted on Amazon S3; File format: flv)*/
<video>
<url>http://s3.amazonaws.com/tmDms/KuEGbWFnZXMyempwZw==</url>
<name>Tour video</name>
<description>cloud</description>
</video>
/* Pickup Locations */
<pickup>
<name>London Heathrow</name>
<street></street>
<area></area>
<city>London</city>
<county></county>
<postcode>SW1</postcode>
<country>UK</country>
<description>at terminal 3 always</description>
</pickup>
<pickup>
<name>Train station</name>
<street>example</street>
<area></area>
<city>London</city>
<county></county>
<postcode>SW2</postcode>
<country>UK</country>
<description>train station</description>
</pickup>
/* A list of trips that the customers can book onto */
<trip>
<tripId>2</tripId>
<startDate>2009-07-18</startDate>
<startTime>09:00:00</startTime>
<endDate>2009-07-18</endDate>
<endTime>17:00:00</endTime>
</trip>
<trip>
<tripId>1</tripId>
<startDate>2009-07-19</startDate>
<startTime>09:00:00</startTime>
<endDate>2009-07-19</endDate>
<endTime>17:00:00</endTime>
</trip>
</tour>
</rsp>