Manage a set of records with IBM Integration Bus REST API services

Learn how to use an IBM Integration Bus REST API service to manage a set of records.

IBM Integration Bus provides a specific REST API project for developing RESTful web service implementations. These services help you define and implement a RESTful service based on the existing Swagger document. These services, which can be invoked from other standard REST or HTTP clients, allow you to send REST requests and receive responses over HTTP. This tutorial shows a simple example where a REST API service implements several functions to query and manage a sample customer registry.

The REST API description allows you to view the RESTful interface that is defined in the imported Swagger document, and allows easy navigation between the REST API interface editor and the subflows that implement the interface operations. In this example, the REST API defines five operations. Each operation can be invoked by a unique combination of the URL path and HTTP method. An operation can make use of a JSON input object and URL parameters. The operations are implemented as subflows that use different transformation nodes. The nodes demonstrate how you can use ESQL, Java, or Graphical Mapping to process an incoming JSON message. The subflows also show you how to construct a response message that includes a JSON response object. You can also generate subflows to handle errors that might occur while processing the REST requests and responses.

You will see how you can deploy and test the REST API on the integration node by using a REST client. As you run the example, you will see how the REST API is deployed as a single entity, which packages your solution.

This tutorial takes approximately 5 minutes.
Start Tutorial
Back To Gallery
Tutorial Topics
  • IBM Integration Bus REST API.
  • Subflows.
  • Transformation using graphical data mapping, Compute and Java Compute nodes.
Learning outcomes
  • Understand how a REST API is defined, implemented, deployed, and invoked.
  • Learn how to implement REST API operations by using subflows.
  • Review how Java Compute, Compute and Mapping nodes can handle messages based on JSON objects.