Tutorial: Creating a SOAP API

This tutorial shows you how to create an API definition by using a SOAP service Web Service Definition Language (WSDL). This API definition simplifies creating and managing access to the SOAP service.

About this tutorial

Follow this tutorial to create an API in API Manager by importing the WSDL for an existing SOAP service. Both SOAP 1.1 and SOAP 1.2 standards are supported by API Connect. When invoked, the API takes a SOAP request from the API caller and uses it to make its own request to the SOAP service. The API then returns the response of the SOAP service. In this tutorial, the SOAP service returns the balance of a fictional bank account for a particular user.

In this tutorial you will complete the following lessons:
  1. Creating a SOAP API
  2. Testing your SOAP API

Before you begin

Note: The Sandbox catalog must be configured to use either a DataPower® API Gateway, or a DataPower Gateway (v5 compatible), or both. See Creating and configuring Catalogs.

Creating a SOAP API

To create an API for an existing SOAP service, complete the following steps.

  1. Download the SOAP WSDL file AccountServicing.txt. Rename this file AccountServicing.wsdl.
  2. Log in to the API Manager UI.
  3. Click the Develop icon.

    API Manager screen

  4. Click Add > API.

    API add menu

  5. Ensure that OpenAPI 2.0 is selected.
  6. Select From existing WSDL service (SOAP proxy). Click Next.

    WSDL confirmation screen

  7. In the File Upload section, either drag and drop the AccountServicing.wsdl file, or click to upload from your filesystem.

    WSDL file upload screen

  8. The file uploads, and is parsed by API Connect. A confirmation message is displayed. Click Next to continue.
  9. The AccountServicing WSDL service gets selected, click Next.

    WSDL Service screen

  10. Leave the values unchanged in the Info section, and click Next.

    API info

  11. In the Secure section, ensure that Secure using Client ID and CORS check boxes are selected. Click Next.

    API Security and Publishing

  12. A Summary screen is now displayed.

    Summary of results (top)

  13. Click Edit API.

    API Info page

  14. Click Validate > with Specifications. Your SOAP API is now online.

You successfully created a SOAP API. The WSDL file provided all the information that was needed to configure the API inputs and response.

Testing your SOAP API

To test your SOAP API, complete the following steps.

  1. Click the Test tab of the AccountServicing API.
  2. Click Target Configuration to open the Preferences dialog box.
  3. Enable the Auto-publish setting and click Save Preferences. You will see the API is now online, indicated by a green marker.
  4. Under Request, click Send to test the API. The API response is displayed in the Response section.

What you did in this tutorial

In this tutorial, you completed the following activities:

  • Created a SOAP API definition.
  • Tested your SOAP API.