IBM Integration Bus, Version 10.0.0.3 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Creating a REST API

To create a REST API in IBM® Integration Bus, you must import a Swagger document by using the IBM Integration Toolkit.

Before you begin

You must create a Swagger document that describes the resources and operations that you want in the REST API, see the Swagger RESTful API Documentation Specification Version 2.0 and Restrictions on Swagger documents.

About this task

To create a REST API in IBM Integration Bus, you must use the Create a REST API wizard in the IBM Integration Toolkit to import a Swagger document. You must then create the REST API and other project artifacts that are required to implement and deploy the new REST API.

Procedure

To create a REST API by importing a Swagger document, complete the following steps:

  1. Open the Create a REST API wizard by clicking File > New > REST API .
  2. Enter a name for the REST API. The name that you specify is used as the name of the project in the IBM Integration Toolkit, as well as the name of the REST API when it is deployed to an integration server.
  3. Select the path to the Swagger document that describes the resources and operations that you want in the REST API. You can import the Swagger document from the file system or from an existing project in the workspace. The file is validated for use in a REST API. If any errors are found while the selected Swagger document is validated, those validation errors are displayed at the top of the wizard. You cannot proceed if validation errors are found in the selected Swagger document.
  4. Optional: To review the list of resources and operations that are contained within the selected Swagger document, click Next.
  5. To finish creating the REST API, click Finish. The REST API Description for the new REST API opens automatically.

Results

The REST API is created.

What to do next

Implement each of the operations in the REST API as a subflow, see Implementing an operation in a REST API.

bi12019_.htm | Last updated 2015-11-27 00:01:40