'On-the-fly' Hotel Mapper API
Overview
The Hotel Mapping service offers clients the ability to map large inventory files, which can take an extended period due to the extensive hotel mapping data sets and complex mapping logic involved.
Additionally, there's an option to map hotels instantly using a dedicated API - 'On-the-fly' Hotel Mapper API.
This method allows you to map hotels in seconds by directly passing the hotel information to the API, resulting in an immediate response from the service.
Key differences between the Hotel Mapping API and the 'On-the-fly' Hotel Mapper API :
| API Flow | Pros | Cons |
|---|---|---|
| Hotel Mapping API | (1) Suitable for large data sets. (2) Results a Mapping files that can be used later for saving / caching. | (1) More complex setup and integration process compared to 'On-the-fly' Hotel Mapper API. (2) Requires mapping files, planning and scheduling of the mapping. (3) The response can take up-to couple hours. |
| 'On-the-fly' Hotel Mapper API | (1) Provides instant mapping results, allowing for immediate data utilization. (2) Can handle multiple Hotel mappings simultaneously, making it suitable for large-scale operations. (3) Easy integration with existing systems due to straightforward API calls. | (1) Pre-defined mapping logic may not be suitable for all use cases. (2) Can map up-to 100 Hotels per single request. |
'On-the-fly' Hotel Mapper API - Documentation
The 'On-the-fly' Hotel Mapper API contains 3 calls, a easy a staring forward solution to mapping hotels in real-time - with instant API response with the mapping details, cross-mapping with the connected suppliers and more.
Requests :
| API Request | Description | Postman API Example |
|---|---|---|
| API Login | Authentication call used to login. (the API is using the cookie-based / session authentication) | Click here. |
| Map | The Map request, gets a single Hotels details, and returns the Mapping information. Along with Gimmonix HotelId and your connected suppliers cross-mapping Ids. | Click here. |
| Map Hotels | The Map Hotels request, gets a list of Hotels (up to 100 Hotels) and returns the Mapping information. Along with Gimmonix HotelId and your connected suppliers cross-mapping Ids. | Click here. |
Step By Step Guide
Step 1 - API Login
Before starting the hotel mapping process, please perform a login request to initiate the connection.
Step 2 - Map Hotel / Hotels.
Once the login is successful, we can proceed with mapping the necessary hotels. Simply pass the hotel information in the request, which will result in instant mapping.
The response will return the hotel mapping information, including cross-mapping IDs from your connected suppliers.
(in this example: Agoda, HotelBeds, and Amadeus).
In this example, we used the Map request. The same process can be applied to multiple properties by using the Map Hotels request.
Example Request - Single Hotel mapping
Example Response - Single Hotel mapping
Step 3 - Mapping is completed.
Updated 6 months ago