Merge pull request #296803 from v-albemi/import-soap-api

AI Freshness Edit: Azure API Management

Author: denrea

articles/api-management/media/restify-soap-api/soap-to-rest.png

@@ -1,63 +1,69 @@
 ---
-title: Import SOAP API to Azure API Management and convert to REST using the portal | Microsoft Docs
-description: 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.
+title: Import a SOAP API to Azure API Management and convert it to REST using the portal | Microsoft Docs
+description: Learn how to import a SOAP API into Azure API Management as a WSDL specification and convert it to a REST API. Then test the API in the Azure portal.
 services: api-management
 author: dlepow
 ms.custom: devdivchpfy22
 ms.service: azure-api-management
 ms.topic: how-to
-ms.date: 03/29/2022
+ms.date: 03/27/2025
 ms.author: danlep
 
+#customer intent: As a developer, I want to import a SOAP API into API Management and convert it to REST.
+
 ---
-# Import SOAP API to API Management and convert to REST
+# Import a SOAP API to API Management and convert it to REST
 
 [!INCLUDE [api-management-availability-all-tiers](../../includes/api-management-availability-all-tiers.md)]
 
-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.
+This article shows how to import a SOAP API as a WSDL specification and then convert it to a REST API. It also shows how to test the API in Azure API Management.
 
 In this article, you learn how to:
 
 > [!div class="checklist"]
-> * Import a SOAP API and convert to REST
+> * Import a SOAP API and convert it to REST
 > * Test the API in the Azure portal
 
 [!INCLUDE [api-management-wsdl-import](../../includes/api-management-wsdl-import.md)]
 
 ## Prerequisites
 
-Complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md)
+- Complete the quickstart [Create an Azure API Management instance](get-started-create-service-instance.md).
 
 [!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-navigate-to-instance.md)]
 
-## <a name="create-api"> </a>Import and publish a back-end API
+## <a name="create-api"> </a>Import and publish a backend API
+
+1. In the left pane, in the **APIs** section, select **APIs**.
+1. On the APIs page, select **+ Add API**.
+1. Under **Create from definition**, select **WSDL**:
 
-1. From the left menu, under the **APIs** section, select **APIs** > **+ Add API**.
-1. Under **Create from definition**, select **WSDL**.
+    :::image type="content" source="./media/restify-soap-api/wsdl-api.png" alt-text="Screenshot that shows the WSDL tile in the Azure portal.":::
 
-    ![SOAP API](./media/restify-soap-api/wsdl-api.png)
-1. In **WSDL specification**, enter the URL to your SOAP API, or select **Select a file** to select a local WSDL file.
-1. In **Import method**, select **SOAP to REST**. 
+1. In **WSDL specification**, enter the URL to your SOAP API, or click **Select a file** to select a local WSDL file.
+1. Under **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](./media/restify-soap-api/soap-to-rest.png)
+    :::image type="content" source="./media/restify-soap-api/soap-to-rest.png" alt-text="Screenshot that shows the SOAP to REST option." lightbox="./media/restify-soap-api/soap-to-rest.png":::
 
-1. The following fields are filled automatically with information from the SOAP API: **Display name**, **Name**, **Description**. Operations are filled automatically with **Display name**, **URL**, and **Description**, and receive a system-generated **Name**.
-1. Enter other API settings. You can set the values during creation or configure them later by going to the **Settings** tab. 
+1. The **Display name** and **Name** boxes are filled automatically with information from the SOAP API. 
+   
+   **Display name**, **URL**, and **Description** information is automatically entered for operations. Operations also receive a system-generated **Name**.
+1. Enter other API settings, and then select **Create**. You can also configure these values later by going to the **Settings** tab. 
 
-    For more information about API settings, see [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial.
-1. Select **Create**.
+    For more information about API settings, see [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api).
 
 ## 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.  
+You can call operations directly from the Azure portal. This method 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.
+1. Select the **Test** tab.
+1. Select an operation.
+
+    The page shows fields for query parameters and fields for the headers. One of the headers is **Ocp-Apim-Subscription-Key**. This header is for the subscription key of the product that's associated with this API. If you created the API Management instance, you're an admin already, so the key is filled in automatically. 
 
-    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. 
-1. Press **Send**.
+1. Select **Send**.
 
     When the test is successful, the backend responds with **200 OK** and some data.
 

articles/api-management/restify-soap-api.md

@@ -2,38 +2,38 @@
 author: vladvino
 ms.service: azure-api-management
 ms.topic: include
-ms.date: 04/16/2021
+ms.date: 03/27/2025
 ms.author: vlvinogr
 ---
 ## Append other APIs
 
-You can compose an API of APIs exposed by different services, including:
+You can compose an API out of APIs that are exposed by different services, including:
+
 * An OpenAPI specification
 * A SOAP API
 * A GraphQL API
-* A Web App hosted in Azure App Service
-* Azure Function App
+* A Web App that's hosted in Azure App Service
+* Azure Functions
 * Azure Logic Apps
 * Azure Service Fabric
 
-Append a different API to your existing API using the following steps. 
-
 >[!NOTE] 
-> When you import another API, the operations are appended to your current API.
+> When you import an API, the operations are appended to your current API.
 
-1. Go to your Azure API Management instance in the Azure portal.
+To append an API to an existing API: 
 
-    :::image type="content" source="./media/api-management-append-apis/service-page-1.png" alt-text="Screenshot of navigating to API Management instance in the portal.":::
+1. Go to your Azure API Management instance in the Azure portal:
 
-1. Select **APIs** on the **Overview** page or from the menu on the left.
+    :::image type="content" source="./media/api-management-append-apis/service-page-1.png" alt-text="Screenshot that shows the API Management services page." lightbox="./media/api-management-append-apis/service-page-1.png":::
 
-    :::image type="content" source="./media/api-management-append-apis/api-select-1.png" alt-text="Screenshot of selecting APIs on Overview page in the portal.":::
+1. Select **APIs** on the **Overview** page or select **APIs** > **APIs** in the menu on the left.
 
-1. Click **...** next to the API that you want to append another API to.
-1. Select **Import** from the drop-down menu.
+    :::image type="content" source="./media/api-management-append-apis/api-select-1.png" alt-text="Screenshot that shows the APIs selection on the Overview page." lightbox="./media/api-management-append-apis/api-select-1.png":::
 
-    :::image type="content" source="./media/api-management-append-apis/append-02.png" alt-text="Select import":::
+1. Select the ellipsis (**...**) next to the API that you want to append another API to.
 
-1. Select a service from which to import an API.
+1. Select **Import** from the drop-down menu:
 
-    :::image type="content" source="./media/api-management-append-apis/select-to-import.png" alt-text="Screenshot of selecting a service in the portal.":::
+    :::image type="content" source="./media/api-management-append-apis/append-02.png" alt-text="Screenshot that shows the Import command." lightbox="./media/api-management-append-apis/append-02.png":::
+
+1. Select a service from which to import an API.

includes/api-management-append-apis.md

@@ -12,14 +12,14 @@ ms.author: danlep
 * [API import limitations](../articles/api-management/api-management-api-import-restrictions.md)
 * [Import an OpenAPI specification](../articles/api-management/import-api-from-oas.md)
 * [Import a SOAP API](../articles/api-management/import-soap-api.md)
-* [Import a SOAP API and convert to REST](../articles/api-management/restify-soap-api.md)
+* [Import a SOAP API and convert it to REST](../articles/api-management/restify-soap-api.md)
 * [Import an App Service API](../articles/api-management/import-app-service-as-api.md)
 * [Import a Container App API](../articles/api-management/import-container-app-with-oas.md)
 * [Import a WebSocket API](../articles/api-management/websocket-api.md)
 * [Import a GraphQL API](../articles/api-management/graphql-api.md)
 * [Import a GraphQL schema and set up field resolvers](../articles/api-management/graphql-schema-resolve-api.md)
-* [Import an Azure Function App](../articles/api-management/import-function-app-as-api.md)
-* [Import an Azure Logic App](../articles/api-management/import-logic-app-as-api.md)
+* [Import an Azure Function App API](../articles/api-management/import-function-app-as-api.md)
+* [Import an Azure Logic App API](../articles/api-management/import-logic-app-as-api.md)
 * [Import a Service Fabric service](/azure/service-fabric/service-fabric-tutorial-deploy-api-management)
 * [Import an Azure OpenAI API](../articles/api-management/azure-openai-api-from-specification.md)
 * [Import an OData API](../articles/api-management/import-api-from-odata.md)

includes/api-management-define-api-topics.md

@@ -2,15 +2,15 @@
 author: dlepow
 ms.service: azure-api-management
 ms.topic: include
-ms.date: 04/16/2021
+ms.date: 03/27/2025
 ms.author: danlep
 ---
 ## Go to your API Management instance
 
-1. In the Azure [portal](https://portal.azure.com), search for and select **API Management services**.
+1. In the Azure [portal](https://portal.azure.com), search for and select **API Management services**:
 
-    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-1.png" alt-text="Select API Management services":::
+    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-1.png" alt-text="Screenshot that shows API Management services in the search results." lightbox="media/api-management-navigate-to-instance/view-apim-1.png":::
 
-1. On the **API Management services** page, select your API Management instance.
+1. On the **API Management services** page, select your API Management instance:
 
-    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-new.png" alt-text="Select your API Management instance":::
+    :::image type="content" source="media/api-management-navigate-to-instance/view-apim-new.png" alt-text="Screenshot that shows an API Management instance on the API Management services page." lightbox="media/api-management-navigate-to-instance/view-apim-new.png":::