Oracle Hospitality API Documentation

repository·main·Indexed 41 days ago

https://github.com/oracle/hospitality-api-docs

REST API specifications and Postman collections for Oracle Hospitality services, including OPERA Cloud Distribution, OPERA Cloud Services, and Reporting and Analytics (R&A) Data APIs via GraphQL. Provides OAS 2.0 specifications and orchestrated API workflows for hotel management, room availability, rates, and inventory (ARI).

Tokens
1.9K
Snippets
7
Records
16
Agent score
54%

What's inside Oracle Hospitality API

  1. Use Reporting and Analytics (R&A) Data APIs via GraphQL

    main
    The Reporting and Analytics (R&A) Data APIs provide dynamic access to Oracle Hospitality R&A data through a GraphQL interface. Instead of traditional REST endpoints, this API uses GraphQL to allow you to retrieve precisely the data required for reporting, organized into logical Subject Areas. This structure is optimized for high-performance data retrieval for reporting purposes.
  2. Use Postman Collections for Hospitality API workflows

    main

    The repository provides Postman collections designed to demonstrate functional workflows for Oracle Hospitality APIs (e.g., digital check-in and checkout).

    To use these collections effectively, you need three components:

    1. Postman Collections: Contain various API call samples for specific functional workflows.
    2. Postman Environment: Defines the main environment variables required to authenticate and execute requests against the Hospitality APIs.
    3. Workflows Documentation: A detailed description of the different workflows supported within the collections.

    You can access these collections directly via the online Postman workspace.

  3. Run OPERA Cloud REST APIs in Postman

    main

    You can access and run the OPERA Cloud REST API collections directly in Postman. There are two primary collections available:

    1. Property REST APIs by Module: Contains the individual API endpoints organized by functional module.
    2. Property REST API Workflows: Contains pre-defined sequences of API calls to execute common business processes (see WORKFLOWS.md for details).

    Important: Both collections require the oracle-hospitality Postman Environment to function correctly. Ensure you have imported the environment file before running the collections.

    https://www.postman.com/hospitalityapis/oracle-hospitality-apis/collection/46029196-cbe581d9-46f5-4d35-8d85-919e23860d42/1-property-rest-apis-by-module/fork?origin=sidebar
  4. Run OPERA Cloud collections in Postman

    main

    The easiest way to start using the OPERA Cloud Postman collections is to fork them directly into your Postman workspace using the provided link. This will import the collection structure and allow you to begin making API calls immediately after configuring your environment variables.

    https://www.postman.com/hospitalityapis/oracle-hospitality-apis/collection/46029196-53613a8c-53f4-4708-b94f-3df6071acccc/4-nor1-upgrade-rest-apis/fork?origin=tab
  5. Run OPERA Cloud API Workflows in Postman

    main

    For complex business logic that requires multiple API calls in sequence, use the Property REST API Workflows collection. This collection is designed to automate common property management tasks through orchestrated API calls. Detailed explanations of how these workflows are structured can be found in the WORKFLOWS.md file within this directory.

    https://www.postman.com/hospitalityapis/oracle-hospitality-apis/collection/15729853-706f9505-6067-42a9-a311-e35051554bfc/2-property-rest-api-workflows/fork?origin=tab
  6. Use OPERA Cloud Postman collections

    main

    You can use Postman collections to interact with Oracle Hospitality OPERA Cloud Services. These collections allow you to test and explore the REST APIs for hotel management functionality.

    To use these collections, you must first import the required environment file to ensure all variables (such as base URLs and authentication tokens) are correctly mapped across the requests.

    Required Environment: ../oracle-hospitality.postman_environment.json
  7. Run Reporting and Analytics Postman collections

    main

    To test and interact with the R&A Data APIs, you can use the provided Postman collection.

    1. Environment Setup: Ensure you have the oracle-hospitality Postman Environment configured. This environment contains the necessary variables for authentication and base URLs.
    2. Import Collection: Use the 'Run in Postman' link to fork the collection directly into your Postman workspace.
    https://www.postman.com/hospitalityapis/oracle-hospitality-apis/collection/cdv8usm/6-r-a-data-apis/fork?origin=sidebar