Amadeus

Amadeus

Amadeus

Asset Version: 1.0
  • Version 1.0
Last Published: Apr 11, 2017 By: Kony Team
77 0 0 8
Amadeus Data Adapter is a useful adapter that helps you rapidly build innovative travel apps. Amadeus Data Adapter connects to the Amadeus Travel Innovation sandbox and retrieves relevant information on the availability of flights, hotels, and rental cars. The adapter supports searching through geo-location, nearby airport, or airport code. The adapter also provides information on SNCF train routes.

Requirements

  • MobileFabric
 

Features

  • Builds connection with Amadeus Travel Innovation Sandbox
  • Provides a list of all Amadeus APIs
  • Makes it easy for you to call Amadeus APIs and view responses
  • Helps you develop travel apps with Amadeus to fetch required results.

Prerequisites

  • Kony account
  • Kony MobileFabric
  • Amadeus account and an App created in it
  • Access key issued by Amadeus when you created an app

Amadeus Data Adapter allows you to make Amadeus API calls directly from MobileFabric. You can import the component into MobileFabric. After you import the component, you can use the MobileFabric console to make Amadeus API calls and view the responses by creating and executing required operations.

Here is a use case that describes the use of Amadeus Data Adapter.

Use Case

Consider a case of a customer who wants to develop an app with the following services using the Amadeus Travel Innovation Sandbox APIs:

  • Search for available flights to travel from one place to another
  • Search for hotels near the airport or within a specific range
  • Search for car or taxi.

In the above use case, you can develop the user interface and functionality of the mobile app using Kony Visualizer. To fetch the search results from Amadeus, you can use MobileFabric with Amadeus Data Adapter. In the MobileFabric console, you can create an integration service with the Amadeus Data Adapter and create operations with the following Amadeus APIs:

  1. Flight Affiliate Search: Displays a list of available flights for the specified source, destination, and day.
  2. Hotel Airport Search: Displays a list of hotels available near the specified airport along with prices, images, and so on.
  3. Car Rental Airport Search: Provides the availability of rental cars near the specified airport along with details, such as price, type of car, and so on.

After you create the necessary operations, you can integrate your mobile app with the integration service that you created with Amadeus Data Adapter.

The following sections help you use the Amadeus Data Adapter component:

Prerequisites

Before you start using the Amadeus Data Adapter, ensure you have the following:

  1. An Amadeus Travel Innovation Sandbox account
  2. An app created in your Amadeus account
  3. Access key issued by Amadeus when you created an app
  4. A Kony account
  5. Kony MobileFabric 7.3

Importing Amadeus Data Adapter

You can import Amadeus Data Adapter into MobileFabric directly from the Kony Marketplace website or by importing the data adapter zip file, which you can download from the Kony Marketplace website.

To import the data adapter zip file, do the following:

  1. Log on to your Kony account. The Dashboard page appears by default.
  2. In the left pane, click the API Management menu. The APIs tab opens by default.
  3. Click the Customer Data Adapters tab. The Custom Data Adapter page appears.
  4. Click Import. The Import Data Adapter dialog appears.
  5. Drag the data adapter zip file into the Drag a Data Adapter box.

    Alternatively, click browse. The Open dialog appears.

    Navigate to the location where you downloaded the data adapter (zip file) on your computer, select the component, and click Open. The Import Data Adapter dialog shows the selected component.

    Note:

    If the selected data adapter zip file is not the one that you want to import, click Remove.

  6. Click Import. The Amadeus data adapter is listed on the Custom Data Adapters page.

Creating an Integration Service with Amadeus

After you import Amadeus Data Adapter into MobileFabric, you must create an integration service with service type as Amadeus to connect with your Amadeus Travel Innovation Sandbox.

To create an integration service with Amadeus, do the following:

  1. Log on to your Kony account. The Dashboard page appears by default.
  2. In the left pane, click the API Management menu. The APIs tab opens by default.
  3. Click the Integration tab. The Integration tab opens with a list of existing integration services.
  4. Click CONFIGURE NEW. The Service Definition tab opens.
  5. In the Name box, type a unique name for your service.
  6. From the Service Type list, select Amadeus.
    Note:

    The Amadeus is listed only after you import the Amadeus Data Adapter into MobileFabric.

  7. In the apiKey box, type the access key provided by the Amadeus.
  8. Click Save.

If the details provided are valid, the MobileFabric service connects to your Amadeus Travel Innovation Sandbox and allows you to make the API calls.

Refer to Integration Services for more information on creating and using integration services.

Creating an Operation

To make any API call in the MobileFabric console, you must create an operation for the respective API and then execute the operation. Executing an operation involves making the API call and displaying the response. For more information, see Executing an Operation.

This section provides steps to create an operation for the Airport Autocomplete API.

Steps to create an operation for the Airport Autocomplete API:

  1. Log on to your Kony account. The Dashboard page appears by default.
  2. In the left pane, click the API Management menu. The APIs tab opens by default.
  3. Click the Integration tab. The Integration page appears with a list of existing integration services.
  4. From the list of integration services, select the integration service that you have created with service type as Amadeus. The Service Definition tab of the selected integration service opens by default.
  5. Click the Operations List tab. The Operations List tab opens.
  6. Click the context menu arrow to expand the Please Select list. The Amadeus Travel Innovation Sandbox is displayed.
  7. Click the plus icon to expand the Amadeus Travel Innovation Sandbox list.
  8. Click the plus icon to expand the Services list, and select Airport_Autocomplete.
  9. Click ADD OPERATION. The Airport_Autocomplete operation is listed in the Configured Operations section.
Note:

You can follow the same steps to create operations for other methods, but ensure that you select the required API.

You can create multiple operations with required APIs and save them in the Configured Operations section. You can then execute the operations when ever required.

Executing an Operation

Executing an operation involves making the API call by setting the necessary parameters and displaying the response. The procedure to execute any operation is same, but the request parameters of the APIs vary. For more information on request parameters of each API, refer Amadeus API Catalog.

This section provides steps to execute the Airport_Autocomplete operation (explained in Creating an Operation).

Steps to execute the Airport_Autocomplete operation:

  1. Log on to your Kony account. The Dashboard page appears by default.
  2. In the left pane, click the API Management menu. The APIs tab opens by default.
  3. Click the Integration tab. The Integration tab opens with a list of existing integration services.
  4. From the list of integration services, select the integration service that you have created with service type as Amadeus. The Service Definition tab of the selected integration service opens by default.
  5. Click the Operations List tab.
  6. Under the Configured Operations section, click the Airport_Autocomplete operation. The Airport_Autocomplete tab opens with the Request Input sub-tab opened by default.
  7. In the Name box, the name of the operation is displayed by default. If you want, you can change the name.
  8. On the Request Input tab, in the Body section, for the following parameters, specify the values in the respective boxes under the Test Value column.
    • term: specify the keyword that represents the start of a word in a city name or airport name.
    • country: specify the country code based on the ISO 3166-1 alpha-2 code.
    • all_airports: Boolean value. Specify the value as true to include all airports available in the specified city name in the response. Specify the value as false to not include all airports.
  9. Click SAVE AND FETCH RESPONSE. The Output Result dialog appears with the response. Otherwise, the Output Result shows an error.