Invoke APIs from API gateway in Integration cloud integrations through REST applications

Knowledge base
, , ,
1

webMethods API Gateway tutorial

          In Integration cloud, integrations can be built to accomplish particular tasks, suppose one has to invoke custom APIs created in API gateway as part of the integration; it can be accomplished through REST applications of the Integration cloud.

         Below section details a way to invoke API gateway APIs as part of integrations [Note: Integration cloud and API gateway are accessed in Software AG cloud

Prerequisites

1. Create a tenant in Software AG Cloud and subscribe for Integration cloud and API gate way

  • Tenant: “TestTenant”

Create API in API gateway

1. Login to Software AG cloud as “TestTenant.

2. Open “API Gateway” > Click “APIs” tab > Click “Create API” button.

3. Select “Import API from URL” [Using “Swagger Petstore” URL as example, which can be found at: https://petstore.swagger.io/ ], provide following values for the attributes

  • URL: “https://petstore.swagger.io/v2/swagger.json“
  • Name: “PetStoreAPI”
  • Type: “Type”
  • Version: “1”

Click “Create”, a page will open as shown below,

1914×873 69.2 KB

Click “Activate” > Click “Yes” in conformation dialogue

Create REST application in Integration Cloud

1. Login to Software AG cloud as “TestTenant.

2. Open “Integration Cloud” > Click “Connect” tab, Click “REST Applications” > Click “Add New Application”, provide below values for the attributes

  • Name: “TestRestApp”
  • Default Endpoint URL: “http://<tenantName>.gateway.webmcloud.com/gateway/PetStoreAPI/1” [This URL can be found at APIs “Technical information” section in API Gateway]
  • Authentication Type: “Credentials”

1914×810 62.5 KB

Click “Next”

3. Click “Add Resource”, provide below values for attributes,

  • Name: “getInventory”
  • Path: “/store/inventory” [it can be found at APIs “Resources and methods” section in API Gateway]

1914×858 64.2 KB

Click “Add”

4. Click “getInventory” > Click “Add Action” , provide below values for attributes

  • Method: “GET”

Under “Request” > “Headers”, add below headers

  • Accept: application/json
  • Content-Type: application/json

Under “Response” > “Headers”, add below headers

  • Accept: application/json
  • Content-Type: application/json

Under “Response” > “Body” > Click “Add Response Body” with below values

  • HTTP Code: 200
  • Content Type: application/json
  • Document Type: Click “Create document” and all the attributes that are needed in response body of the rest call [Used empty document in the example]

Click “Add”

Click “Add” for resource > Click “Next” > Click “Finish”

5. Click “TestRestApp” > Click “Add New Account” and provide below values for attribute

  • Save as: “APIGateway_Account”
  • Server URL: “http://<tenantName>.gateway.webmcloud.com/gateway/PetStoreAPI/1”

Click “Save”

6. Click “Operations” tab, Click “Add New Operation”

  • Save as: “Operation”
  • Select “APIGateway_Account” for Account, Click “Next”
  • Select “getgetInventory” for operation, Click “Next”

Click “Next” > Click “Next” > Click “Finish”

Select “Operation” and Click “Test” to test the working of the created operation, under provided empty document in response body, all the pet inventory results will be shown

1914×897 73.2 KB

7. In the Integration Cloud Click “Develop” > Click “Add New Integration” > Select “Orchestrate two or more applications” > Click “Applications” in navigation panel and search for the created REST application “TestRestApp”. Now created application can be used as part of the Integrations

1914×866 35.9 KB