Service Methods

This section covers some of the common structures and the methods that could be used probably at once. The common structures are 'Credentials' required in every request and 'Status' that will be received by client in every response. Methods could be used once are 'CountryList()', 'DestinationCityList()', 'TopDestinations()', 'GiataHotelCodeList()'.

1.CountryList()

This method is used to get list of Countries where an agent can request for hotels.

Note: No input parameters required, need to give credentials only to call this method.

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:hot="http://TekTravel/HotelBookingApi">
  <soap:Header xmlns:wsa='http://www.w3.org/2005/08/addressing'>
    <hot:Credentials xmlns:hot="http://TekTravel/HotelBookingApi" UserName="testuser" Password="testpwd">
    </hot:Credentials>
    <wsa:Action>http://TekTravel/HotelBookingApi/CountryList</wsa:Action>
    <wsa:To>http://api.tbotechnology.in/hotelapi_v7/hotelservice.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <hot:CountryListRequest/>
  </soap:Body>
</soap:Envelope>

Response

<CountryListResponse xmlns="http://TekTravel/HotelBookingApi">
  <Status>
    <StatusCode>01</StatusCode>
    <Description>Successful: CountryList Successful</Description>
  </Status>
  <CountryList>
    <Country CountryName="Yemen Republic" CountryCode="YE"/>
    <Country CountryName="Zambia" CountryCode="ZM"/>
    <Country CountryName="Zimbabwe" CountryCode="ZW"/>
  </CountryList>
</CountryListResponse>

2.DestinationCityList()

This method will provide all the supported destinations (List of cities) in a Country.

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:hot="http://TekTravel/HotelBookingApi">
  <soap:Header xmlns:wsa='http://www.w3.org/2005/08/addressing'>
    <hot:Credentials xmlns:hot="http://TekTravel/HotelBookingApi" UserName="testuser" Password="testpwd">
    </hot:Credentials>
    <wsa:Action>http://TekTravel/HotelBookingApi/DestinationCityList</wsa:Action>
    <wsa:To>http://api.tbotechnology.in/hotelapi_v7/hotelservice.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <hot:DestinationCityListRequest>
      <hot:CountryCode>AE</hot:CountryCode>
     <hot:ReturnNewCityCodes>true</hot:ReturnNewCityCodes>
    </hot:DestinationCityListRequest>
  </soap:Body>
</soap:Envelope>

Response

<DestinationCityListResponse xmlns="http://TekTravel/HotelBookingApi">
  <Status>
    <StatusCode>01</StatusCode>
    <Description>Successful: DestinationCityList Successful</Description>
  </Status>
  <CountryName>United Arab Emirates</CountryName>
  <CityList>
    <City CityCode="100765" CityName="Abu Dhabi"/>
    <City CityCode="100687" CityName="Ajman"/>
    <City CityCode="151807" CityName="Bur Dubai"/>
    <City CityCode="115936" CityName="Dubai"/>
  </CityList>
</DestinationCityListResponse>

3.TopDestinations()

This method is used to get list of destination cities which are popular, demand of hotels are high or you get high inventory.
Note: No input parameters required, need to give credentials only to call this method.

Request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:hot="http://TekTravel/HotelBookingApi">
  <soap:Header xmlns:wsa='http://www.w3.org/2005/08/addressing'>
    <hot:Credentials xmlns:hot="http://TekTravel/HotelBookingApi" UserName="testuser" Password="testpwd">
    </hot:Credentials>
    <wsa:Action>http://TekTravel/HotelBookingApi/TopDestinations</wsa:Action>
    <wsa:To>http://api.tbotechnology.in/hotelapi_v7/hotelservice.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <hot:TopDestinationsRequest/>
  </soap:Body>
</soap:Envelope>

Response

<TopDestinationsResponse xmlns="http://TekTravel/HotelBookingApi">
  <Status>
    <StatusCode>01</StatusCode>
    <Description>Successful: TopDestinations Successful</Description>
  </Status>
  <CityList>
    <City CityCode="25906" CityName="Abu Dhabi" CountryCode="AE" CountryName="United Arab Emirates"/>
    <City CityCode="32343" CityName="Aden" CountryCode="YE" CountryName="Yemen"/>
    <City CityCode="25908" CityName="Al Ain" CountryCode="AE" CountryName="United Arab Emirates"/>
  </CityList>
</TopDestinationsResponse>

4.GiataHotelCodeList()

This method is used to get list of TBO Mapped properties detail. Using the HotelCodes that you receive in the response, you may call HotelDetails method to get the complete details of the hotel.

Request (Option 1)

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:hot="http://TekTravel/HotelBookingApi">
  <soap:Header xmlns:wsa='http://www.w3.org/2005/08/addressing'>
    <hot:Credentials xmlns:hot="http://TekTravel/HotelBookingApi" UserName="testuser" Password="testpwd">
    </hot:Credentials>
    <wsa:Action>http://TekTravel/HotelBookingApi/GiataHotelCodes</wsa:Action>
    <wsa:To>http://api.tbotechnology.in/hotelapi_v7/hotelservice.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <hot:GiataHotelCodesRequest>
     <hot:CityCode>115936</hot:CityCode>
     <hot:IsDetailedResponse>false</hot:IsDetailedResponse>
    </hot:GiataHotelCodesRequest>
  </soap:Body>
</soap:Envelope>

Request (Option 2)

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:hot="http://TekTravel/HotelBookingApi">
  <soap:Header xmlns:wsa='http://www.w3.org/2005/08/addressing'>
    <hot:Credentials xmlns:hot="http://TekTravel/HotelBookingApi" UserName="testuser" Password="testpwd">
    </hot:Credentials>
    <wsa:Action>http://TekTravel/HotelBookingApi/GiataHotelCodes</wsa:Action>
    <wsa:To>http://api.tbotechnology.in/hotelapi_v7/hotelservice.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <hot:GiataHotelCodesRequest>
     <hot:CityCode>115936</hot:CityCode>
     <hot:IsDetailedResponse>true</hot:IsDetailedResponse>
    </hot:GiataHotelCodesRequest>
  </soap:Body>
</soap:Envelope>

Response

<GiataHotelCodesResponse xmlns="http://TekTravel/HotelBookingApi">
  <Status>
    <StatusCode>01</StatusCode>
    <Description>Successful: GiataHotelCodeList Successful</Description>
  </Status>
 <Hotels>
  <Hotel HotelCode="1002877" HotelName="Pearl Marina Hotel Apartments" HotelAddress="Al Marsa Street Marina Water Front " Latitude="25.06944" Longitude="55.12894" StarRating="ThreeStar" CountryName="United Arab Emirates" CityName="Dubai"/>
  <Hotel HotelCode="1009942" HotelName="The Oberoi Dubai" HotelAddress="Business Bay PO Box 71847 " Latitude="25.18714" Longitude="55.26388" StarRating="FiveStar" CountryName="United Arab Emirates" CityName="Dubai"/>
  <Hotel HotelCode="1010430" HotelName="Barjeel Heritage Guest House" HotelAddress="Al Ghubaiba P.O.Box 46500 " Latitude="25.26462" Longitude="55.28965" StarRating="All" CountryName="United Arab Emirates" CityName="Dubai"/>
  <Hotel HotelCode="1013167" HotelName="Dubai Creek Golf & Yacht Club" HotelAddress="P.O. Box 24040 Dubai " Latitude="25.241557" Longitude="55.33366" StarRating="ThreeStar" CountryName="United Arab Emirates" CityName="Dubai"/>
  <Hotel HotelCode="1013577" HotelName="Hilton Dubai The Walk" HotelAddress="THE WALK JUMEIRAH BEACH RESIDENCE " Latitude="25.07857" Longitude="55.13389" StarRating="FourStar" CountryName="United Arab Emirates" CityName="Dubai"/>
 </Hotels>
</GiataHotelCodesResponse>