Generate Oracle Hospitality Access Tokens

Use this recipe to generate an access token from the Oracle Hospitality Integration Platform (OHIP).

Note:

This recipe is available as Oracle Integration — Oracle Hospitality | Generate Access Tokens in the Integration Store. Oracle provides this recipe as a sample only. The recipe is meant only for guidance, and is not warranted to be error-free. No support is provided for this recipe.

Overview

You require an OHIP access token to call any Oracle Hospitality API. In addition, the tokens you obtain expire after sixty minutes. Using this recipe, you can automatically generate these tokens at a frequency of your choosing (for example, every thirty or sixty minutes), and use the tokens to seamlessly call the required Oracle Hospitality APIs.

To use the recipe, you must install the recipe package and configure the connection and other resources within the package. Subsequently, you can activate and run the integration flow of the package manually or specify an execution schedule for it. When triggered, the integration flow queries OHIP for an access token (using the credentials configured in the recipe's resources) and returns the token details in a log message. After an integration instance successfully executes, you can view the log message containing the token through the Activity Stream.

System Requirements

  • Oracle Integration, Version 21.2.1.0.0 or higher

Assumptions

  • You have created an integration user account on the Oracle Hospitality Shared Security Domain (SSD) for the required hotel's tenant/chain, and possess a valid Integration ID and Integration Key for the account. See Partner Self-Registration Guide on the Oracle Hospitality Shared Security Domain (SSD) for OPERA documentation page.
  • You have added a new environment in the Oracle Hospitality Developer Portal to access the hotel’s environment, and obtained the Gateway URL, Client ID, and Client Secret of the environment added. See Adding an Environment and Viewing Environment Details in Oracle Hospitality Integration Platform User Guide.
  • You have registered an application in the Oracle Hospitality Developer Portal (by selecting the right environment and subscribing to the required group of Oracle Hospitality APIs), and obtained the Application Key. See Registering an Application and Viewing the Application Key in Oracle Hospitality Integration Platform User Guide.