powering tour and activity businesses worldwide

Make Something Cool with the Rezgo API at THack London

Rezgo will once again be participating in THack, the travel hack-a-thon developed by Tnooz.com.  On June 28th, 2012 developers from around the globe will convene in London to present their creations to a live audience.

Rezgo will be providing API access and developers for the THack London 2012

From the Tnooz website

[quote style="boxed"]THack London will follow a similar path to the first THack in February 2011 – developers will have TWO WEEKS to create something using the APIs we are making available, as well as using any other freely available API on the web (such as Facebook, Twitter, Google Maps, Wikipedia, et al).[/quote]

Developers interested in using the Rezgo XML API can use the following resources.  Developers are also encouraged to contact us should you have any questions or need assistance.

Amazing Tours Rezgo Site

This is live vendor account with about 450 available products.  The vendor account uses a live payment gateway, so real booking requests should not be committed to the account.  You are free to take the booking to the point of payment.  The following link is the live front-end booking engine for the Amazing Tours site.

http://amazing.rezgo.com

API Credentials

The following credentials will be required to authenticate your requests to the XML API.  You will find the credentials used in the sample queries below.

Company Code / CID: p103
API Key: 2D8-F3V0-X7C0-C6I

Documentation

For complete documentation on all the calls available through the XML API, refer to the following section on the Rezgo support site.

https://www.rezgo.com/support-category/xml-api/

Downloadable Source Code

If you are looking for a place to start, download this open source package.  The PHP code provided in this package is a complete working version of the front-end booking engine available on Rezgo.com.  To use the PHP code, you will need the CID and API Key specified above.

http://sourceforge.net/projects/rezgo/

Support for Developers

If you require any assistance, feel free to contact us through any of the following methods:

Email – support@rezgo.com
Skype – rezgo.support
Phone – +1 (604) 983-0083

When contacting us, please be sure to mention that you are part of THack 2012.

Sample XML Queries

Company About Information

This query returns the company profile details.  In this case, the information returned will be for Amazing Tours.
http://xml.rezgo.com/xml?key=2D8-F3V0-X7C0-C6I&transcode=p103&i=company

Get Available Tags

The query returns a list of the tags used in the account along with a count of the tours associated with each tag.
http://xml.rezgo.com/xml?key=2D8-F3V0-X7C0-C6I&transcode=p103&i=tags

Search Items with specific tag

This query searches the account for items that match based on specific tag (or tags). In this case, the API will return all tours that are tagged with "sightseeing".
http://xml.rezgo.com/xml?key=2D8-F3V0-X7C0-C6I&transcode=p103&i=search_items&t=tag&q=sightseeing

Search Items with Date (Availability)

This query searches all tours for items that have availability on a given date.  The API will return a list of every tour in the account along with corresponding availability.  To display only tours that are available, you will need to parse through the results and show only those that have availability.  Note: This is a large result set.
http://xml.rezgo.com/xml?key=2D8-F3V0-X7C0-C6I&transcode=p103&i=search_items&t=name&q=*&d=2012-08-01

Retrieve Availability for a Specific Tour

This query returns availability for a specific item. In this case, the availability for item SKU 28170 on August 1, 2012.
http://xml.rezgo.com/xml?key=2D8-F3V0-X7C0-C6I&transcode=p103&i=search_items&t=com&q=28170&d=2012-08-01

Retrieve Monthly Availability for a Specific Tour

This query will return a list of daily availability for a specific tour in a specific month.  The results are shown as a breakdown of each option for the tour along with availability for each.
http://xml.rezgo.com/xml?key=2D8-F3V0-X7C0-C6I&transcode=p103&i=month&g=1&q=28170&d=2012-08-01

Retrieve Monthly Availability for a Specific Tour Option

This query will return a list of daily availability for a specific tour option.  The query is identical to the previous one with the exception that the This examples returns one of the two options for the tour specified in the previous query.
http://xml.rezgo.com/xml?key=2D8-F3V0-X7C0-C6I&transcode=p103&i=month&g=1&q=28425&d=2012-08-01

Commit a Booking

This query will commit a booking to the XML API.  You can use this query if you want to simulate a booking.  You'll be provided with a successful booking that is "Payment Pending".
https://xml.rezgo.com/xml?transcode=4385&key=9I0-R1P2-G8M4-V3Y&i=commit&&date=2012-08-01&book=32050&adult_num=2&tour_first_name=John&tour_last_name=Doe&tour_address_1=123+Anywhere&tour_city=Vancouver&tour_stateprov=BC&tour_country=ca&tour_postal_code=V7V+1V1&tour_phone_number=604-555-1212&tour_email_address=john.doe%40example.com&tour_group[adult][1][first_name]=John&tour_group[adult][1][last_name]=Doe&tour_group[adult][1][phone]=604-555-1212&tour_group[adult][1][email]=john.doe%40example.com&tour_group[adult][1][forms][7365]=Intermediate&tour_group[adult][1][forms][7366]=on&tour_group[adult][2][first_name]=Jane&tour_group[adult][2][last_name]=Doe&tour_group[adult][2][phone]=604-555-1212&tour_group[adult][2][email]=jane.doe%40example.com&tour_group[adult][2][forms][7365]=Intermediate&tour_group[adult][2][forms][7366]=on&payment_method=Credit+Cards&tour_card_token=3T5K9O0P9K1339184838&agree_terms=1

Written by

Stephen is the CEO and Co-Founder of Rezgo. He has been working as a travel & tourism technology consultant since 1995. Stephen is active in fostering tourism technology and is a Past Chair of the OpenTravel Alliance. He is also a regular contributor for Tnooz, a leading travel technology media site, and speaks regularly at conferences around the Globe on travel & tourism technology, messaging standards, and industry trends.

We would love your feedback