restify-soap-api.md

title	description	services	documentationcenter	author	manager	editor	ms.service	ms.workload	ms.tgt_pltfrm	ms.devlang	ms.topic	ms.date	ms.author
Import a SOAP API and convert to REST using the Azure portal | Microsoft Docs	Learn how to import a SOAP API and convert it to REST with API Management.	api-management		vladvino	cfowler		api-management	mobile	na	na	tutorial	11/22/2017	apimpm

Import a SOAP API and convert to REST

This article shows how to import a SOAP API and convert it to REST. The article also shows how to test the APIM API.

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
• Test the API in the Developer portal

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. Select APIs from under API MANAGEMENT.

2. Select WSDL from the Add a new API list.

   

3. In the WSDL specification, enter the URL to where your SOAP API resides.

4. Click SOAP to REST radio button. When this option is clicked, APIM attempts to make an automatic transformation between XML and JSON. In this case consumers should be calling the API as a restful API, which returns JSON. APIM is converting each request into a SOAP call.

   

5. Press tab.

   The following fields get filled up with the info from the SOAP API: Display name, Name, Description.

6. Add an API URL suffix. The suffix is a name that identifies this specific API in this APIM instance. It has to be unique in this APIM instance.

7. Publish the API by associating the API with a product. In this case, the "Unlimited" product is used. If you want for the API to be published and be available to developers, add it to a product. You can do it during API creation or set it later.

   Products are associations of one or more APIs. You can include a number of APIs and offer them to developers through the developer portal. Developers must first subscribe to a product to get access to the API. When they subscribe, they get a subscription key that is good for any API in that product. If you created the APIM instance, you are an administrator already, so you are subscribed to every product by default.

   By default, each API Management instance comes with two sample products:

   • Starter
   • Unlimited

8. Select Create.

Test the new APIM 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. Press the Test tab.

3. Select some operation.

   The page displays 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 APIM instance, you are an administrator already, so the key is filled in automatically.

4. Press Send.

   Backend responds with 200 OK and some data.

Call an operation from the developer portal

Operations can also be called Developer portal to test APIs.

1. Select the API you created in the "Import and publish a back-end API" step.

2. Press Developer portal.

   The "Developer portal" site opens up.

3. Select the API that you created.

4. Click the operation you want to test.

5. Press Try it.

6. Press Send.

   After an operation is invoked, the developer portal displays the Response status, the Response headers, and any Response content.

[!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