Documentation

Hotel Content API

In order to understand the importance of the ContentAPI it's necessary to understand that the information returned by APItude is classified into two categories:

  • Static information: information not directly related to the booking process - comments, descriptions, hotel pictures and address information...
  • Dynamic information: information related to the booking process that can change at any time: prices, availability dates, cancellation policies, and fees...

APItude's BookingAPI core concept is to return results in a simple format in the shortest possible time. To achieve this we limit the size of the response messages returning just the dynamic information of the hotel booking process, but the static information also has its importance.

The ContentAPI is an API designed to return all the static information needed to operate the BookingAPI as quickly and simple as possible, faster and more reliable than having the information on an FTP server.

Managing hotel contents

ContentAPI has been designed to retrieve all the details of the hotels available in our BookingAPI. ContentAPI contains several methods that allow you to obtain the details of the hotels as well as a list of destinations, countries and the master types that complement the hotel's information (like room type descriptions, accommodation type descriptions, categories descriptions...).

The main operation that we have is the Hotels Operation which is connected to the rest of the methods, we can consider three different connections based on the information returned in each operation:

Note that the Languages operation will be connected to all the operations in which a description is returned since we will return the language code in which that description has been returned.

Hotel Descriptive Operations

In this group we consider all the operations that can be used to describe each hotel:

Descriptive_Graphs


As you can see the main operation Hotels are, supported by the types that describe the accommodation types, segments of the hotel, categories, chains, image types, and facilities.

Remember that in the operation Hotels we will return you the codes and in the descriptive operations, we will give you the description of each code. 

Hotel Location Operations

In this group we consider all the operations that can be used to locate each hotel:

Location_Graphs


As you can see the main operation Hotels are, supported by the Locations Operation (to obtain destinations and zones) and the Countries operation.

Remember that in the operation Hotels we will return you the codes and in the location operations, we will give you the description of each code. 

Hotel Complementary Operations

In this group we consider all the operations that can be used to complement the information of the hotels as well as the information returned in our BookingAPI:

Complementary_Graphs


As you can see the main operation Hotels is supported by the several operations that give you descriptions of the rooms, board types, issues or terminals associated with the hotel. Also, we have the operation Rates Comments that inform of the comments the hotelier wants the client to know before confirming the booking, this rate comment will be returned in the BookingAPI so you need to have it in your database to be able to serve the information promptly. 

Remember that in the operation Hotels we will return you the codes and in the complementary operations we will give you the description of each code. 



Other Operations

In this group we consider all the operations that are not directly related to the hotels but can be used to complement the information returned in our BookingAPI:

Other_Graphs



Here we have the descriptions of the currencies returned in the BookingAPI as well as the promotions that each rate can have.