Skip to content

Files

Latest commit

Shiny11AShiny11A
first draft for peer review
Mar 29, 2022
bef41e4 · Mar 29, 2022

History

History
69 lines (46 loc) · 3.22 KB

restify-soap-api.md

File metadata and controls

69 lines (46 loc) · 3.22 KB
title description services author ms.custom ms.service ms.topic ms.date ms.author
Import SOAP API to Azure API Management and convert to REST using the portal | Microsoft Docs
Learn how to import a SOAP API to Azure API Management as a WSDL specification and convert it to a REST API. Then, test the API in the Azure portal.
api-management
dlepow
devdivchpfy22
api-management
how-to
03/29/2022
danlep

Import SOAP API to API Management and convert to REST

This article shows how to import a SOAP API as a WSDL specification and then convert it to a REST API. The article also shows how to test the API in API Management.

In this article, you learn how to:

[!div class="checklist"]

  • Import a SOAP API and convert to REST
  • Test the API in the Azure portal

[!INCLUDE api-management-wsdl-import]

Prerequisites

Complete the following quickstart: Create an Azure API Management instance

[!INCLUDE api-management-navigate-to-instance.md]

Import and publish a back-end API

  1. From the left menu, under the APIs section, select APIs > + Add API.

  2. Under Create from definition, select WSDL.

    SOAP API

  3. In WSDL specification, enter the URL to your SOAP API, or select Select a file to select a local WSDL file.

  4. In Import method, select SOAP to REST. When this option is selected, API Management attempts to make an automatic transformation between XML and JSON. In this case, consumers should call the API as a RESTful API, which returns JSON. API Management converts each request to a SOAP call.

    SOAP to REST

  5. The following fields are filled automatically with information from the SOAP API: Display name, Name, Description.

  6. Enter other API settings. You can set the values during creation or configure them later by going to the Settings tab.

    For more information about API settings, see Import and publish your first API tutorial.

  7. Select Create.

Test the new API in the Azure portal

Operations can be called directly from the Azure portal, which provides a convenient way to view and test the operations of an API.

  1. Select the API you created in the previous step.

  2. Select the Test tab.

  3. Select an operation.

    The page shows fields for query parameters and fields for the headers. One of the headers is Ocp-Apim-Subscription-Key, for the subscription key of the product that is associated with this API. If you created the API Management instance, you're an admin already, so the key is filled in automatically.

  4. Press Send.

    When the test is successful, the backend responds with 200 OK and some data.

[!INCLUDE api-management-navigate-to-instance.md]

[!INCLUDE api-management-define-api-topics.md]

Next steps

[!div class="nextstepaction"] Transform and protect a published API