2. Catalogue

Last modified by Giorgi Mdivnishvili on 2024/04/11 15:51

API Methods Overview

This section provides a concise overview of the available API methods designed to retrieve various types of geographical and accommodation-related data. Each method supports parameters to refine search results, catering to specific data retrieval needs.

GetDestinationCountries

  • Description: Retrieves a list of destination countries. This method allows for specifying parameters to filter the returned list according to certain criteria.
  • Usage: Ideal for obtaining a comprehensive list of countries to which travel services are provided, including package destinations.

GetCountries

  • Description: Fetches a complete list of countries. Similar to GetDestinationCountries, this method supports various parameters for filtering the country list.
  • Usage: Useful for applications needing to present a global perspective, offering users a selection of countries without specific destination criteria.

GetDepartureCities

  • Description: Obtains a list of all cities from which departures are available. This method does not require parameters and provides a straightforward list based on available data.
  • Usage: Essential for setting up departure points in travel booking systems or for analytics related to departure locations.

GetArrivalDistricts

  • Description: Generates a list of districts available for arrival. This method focuses on more granular geographic locations, aiding in detailed travel planning and organization.
  • Usage: Best suited for applications requiring detailed destination planning down to the district level.

GetHotels

  • Description: Compiles a list of all hotels available in the system. This method is crucial for accommodation-focused queries and supports parameters to narrow down options.
  • Usage: Central to hotel booking platforms or travel packages that include accommodation options.

GetAirportTree

  • Description: Provides a structured list of airports. This method is tailored for retrieving hierarchical airport data, useful for flight-related functionalities.
  • Usage: Integral for flight booking services, airport selection interfaces, and logistic applications focusing on air travel.

Each method is designed with flexibility and specific use cases in mind, ensuring developers can easily integrate and utilize the provided data in their applications, enhancing user experiences and backend functionalities.

Important

Error

Implementing Authorization in Subsequent Requests

For every API request after the initial authentication, it's crucial to include the authorization token in the request header. This ensures your requests are authorized and can access the necessary resources. Here's how to properly include your token:

  • Header Key: Authorization
  • Header Value: Bearer [Your Token Here] - Use the bearer token provided in the initial authentication response. The authorization type should be specified as Bearer Token.

Additionally, to ensure your requests are properly formatted and recognized, include the following headers:

  • Content-Type: Specify this header as application/json to indicate the format of the request body.
  • Header Key: X-nugios-timezone
  • Header Value: 240 - Adjust this value to match your local timezone offset in minutes.

Incorporating these headers with their respective values is essential for the successful processing of your API requests.