Calling External REST APIs in Oracle Integration Cloud : Integration (2024)

In the ever-evolving landscape of cloud-based integration solutions, Oracle Integration Cloud (OIC) stands out as a powerful platform that facilitates seamless connectivity between diverse applications and services. One of the key features that empowers this connectivity is the REST Adapter, allowing users to effortlessly call external REST APIs. In this blog post, we’ll explore the process of invoking external REST APIs in OIC using the REST Adapter and delve into the benefits of this integration approach.

In this blog, We will cover

Understanding the REST Adapter in OIC
Steps To Perform To Call An External REST API
Step by step : Calling External REST API in OIC Using REST Adapter
Benefits of Using REST Adapter in OIC
Conclusion

Understanding the REST Adapter in OIC

The REST Adapter in Oracle Integration Cloud provides a straightforward means of interacting with external RESTful services. Whether you need to consume data from a third-party API or push information to an external system, the REST Adapter simplifies the integration process. Let’s walk through a basic scenario to illustrate how you can call an external REST API within an OIC integration.

Steps To Perform To Call An External REST API

Create an Integration: Begin by creating a new integration within Oracle Integration Cloud.
Configure REST Adapter Connection: Drag and drop the REST Adapter onto the integration canvas. Configure the connection details, including the base URL of the external REST API, authentication credentials, and any required headers.
Define Trigger and Actions: Define the trigger for your integration, specifying when the integration should be triggered to call the external REST API. Add actions within the integration flow, such as data transformations or enrichments.
Invoke External REST API: Use the REST Adapter within the integration flow to invoke the external REST API. Configure the request method (GET, POST, PUT, DELETE) and provide any required parameters or payload.
Handle Response: Implement error handling and response processing within the integration to manage various scenarios, ensuring the robustness of your integration.
Testing: Before deploying the integration, leverage OIC’s testing capabilities to ensure that the integration works as expected.

To know More : Adapters in OIC

Step by step : Calling External REST API in OIC Using REST Adapter

CREATE A CONNECTION USING REST ADAPTER

Create a connection using Rest Adapter.
Enter Name as your own choice and select Trigger from Role type drop down. We have selected Trigger as we want to expose this REST connection as a REST service. Means this will work as an endpoint for the end user
As this is the Trigger REST connection, you don’t need to configure anything in this. Leave all as it is. And click on the Test button in the upper right corner. If everything goes fine, the progress bar will reach 100%.

CREATE A EXTERNAL REST CONNECTION IN OIC

The next screen displays all different types of adapters available on OIC. Search REST and select REST Adapter.
Enter Name as your own choice
Enter below details as below and click the OK button: Connection Type: REST API Base URL
Connection URL: Enter the base URL of REST API as
Provide the link for connection URL.
Enter your oracle cloud account details. In the place of security.
Click on Test button again and it will be successfully tested. If you want to test Your integration with external tools like Postman or SOAP UI add basic authentication also,

CREATE AN INTEGRATION

Mention Name in What do you want to call your integration
Drag the REST Trigger connection
Mention What you want to call your endpoint
Enter the information below and Click Next.
In select the response payload format selects JSON Sample: This option allows us to take input in json format. Select inline link to give sample payload.
Enter the payload according to your requirements.
Check the summary and click on finish
Click Invokes from right navigation, Drop the Rest adapter we created in the previous step and configure below Map of GetTodo.
Enter the information, what you want to call your endpoint and action to perform
Select payload format as JSON and Enter the Payload
Now click on actions and Add the Mapper to Map Call Todos.
Map the data and validate.
Add the Business Identifiers at last and activate the integration to test.

Activate and Test the Integration

Test the integration with inbuilt tool, you can also use postman or Soap ui.

Benefits of Using REST Adapter in OIC

Simplicity and Agility: The REST Adapter’s intuitive design makes it easy for users to quickly configure and deploy integrations, promoting agility in responding to changing business requirements.
Seamless Connectivity: OIC’s REST Adapter facilitates seamless connectivity with a wide array of external RESTful services, enabling organizations to integrate with various platforms effortlessly.
Efficient Data Handling: With built-in features for handling RESTful requests and responses, the adapter streamlines data exchange, ensuring efficiency in data processing.
Monitoring and Logging: OIC provides robust monitoring and logging capabilities, allowing users to track the performance of integrations and troubleshoot issues effectively.

Conclusion

Calling external REST APIs in Oracle Integration Cloud using the REST Adapter opens up a world of possibilities for organizations seeking to create interconnected and streamlined workflows. With its user-friendly interface and powerful capabilities, OIC empowers businesses to adapt to the demands of the digital landscape by seamlessly integrating with external services. Embrace the REST Adapter in OIC and take the next step towards achieving a more connected and efficient integration environment.

Frequently Asked Questions

What is the REST Adapter in Oracle Integration Cloud?

The REST Adapter in OIC is a component that facilitates seamless integration with external RESTful services. It enables users to connect to and interact with external APIs, making it a crucial tool for building comprehensive and interconnected workflows.

How do I configure the REST Adapter connection in OIC?

To configure the REST Adapter connection in OIC: Drag and drop the REST Adapter onto the integration canvas. Provide the necessary connection details, such as the base URL of the external REST API, authentication credentials, and any required headers.

What are the supported request methods in the REST Adapter?

The REST Adapter supports common HTTP request methods, including GET, POST, PUT, and DELETE. These methods allow you to perform different actions when interacting with external REST APIs.

Can I handle authentication for external REST APIs in OIC?

Yes, the REST Adapter supports various authentication methods, such as basic authentication, OAuth, and API key authentication. You can configure the adapter to ensure secure communication with external APIs.

How do I pass parameters to an external REST API using the REST Adapter?

Within the REST Adapter configuration, you can define parameters and headers as part of the request. This allows you to pass dynamic values, query parameters, or any necessary information required by the external API.

Next Task For You

Do you want to learn more about Oracle and confuse where to start or which certification is right for you? Then, click on theregister nowbutton below to register for aFree MasterclassonOracle [1Z0-1042] Certified Cloud Integration Expert,which will help you better understand and choose the right path and clear the certification exam.