Importare un'API SOAP in Gestione API di Azure e convertirla in REST

SI APPLICA A: tutti i livelli di Gestione API

Questo articolo illustra come importare un’API SOAP come specifica WSDL e quindi convertirla in un’API REST. Illustra anche come testare l'API in Gestione API di Azure.

In questo articolo vengono illustrate le operazioni seguenti:

Prerequisiti

• Creare un'istanza di Gestione API di Azure.

Passare all'istanza di Gestione API

1. Nel portale di Azure cercare e selezionare Servizi gestione API:

   

2. Nella pagina Servizi Gestione API selezionare l'istanza di Gestione API:

   

Importare e pubblicare un'API back-end

1. Nella sezione API del menu della barra laterale selezionare API.

2. Nella pagina API selezionare + Aggiungi API.

3. In Crea da definizione selezionare il riquadro WSDL:

   

4. In Specifica WSDL immettere l'URL dell'API SOAP oppure scegliere Seleziona un file per selezionare un file WSDL locale.

5. In Metodo di importazione selezionare SOAP in REST.

   Quando questa opzione è selezionata, Gestione API tenta di eseguire una trasformazione automatica tra XML e JSON. In questo caso, i consumer devono chiamare l’API come API RESTful, che restituisce JSON. Gestione API converte ogni richiesta in una chiamata SOAP.

   

6. Le caselle Nome visualizzato e Nome vengono compilate automaticamente con le informazioni dell'API SOAP.

7. Immettere altre impostazioni API e quindi selezionare Crea. È anche possibile configurare questi valori in un secondo momento passando alla scheda Impostazioni .

   Per altre informazioni sulle impostazioni api, vedere Importare e pubblicare un'API back-end.

Testare la nuova API nel portale di Azure

È possibile chiamare le operazioni direttamente dal portale di Azure. Questo metodo offre un modo pratico per visualizzare e testare le operazioni di un'API.

1. Selezionare l'API creata nel passaggio precedente.

2. Selezionare la scheda Test.

3. Selezionare un'operazione.

   La pagina mostra i campi per i parametri di query e i campi per le intestazioni. Una delle intestazioni è Ocp-Apim-Subscription-Key. Questa intestazione è per la chiave di sottoscrizione del prodotto associato all'API. Se è stata creata l’istanza di Gestione API, si è già un amministratore, quindi la chiave viene compilata automaticamente.

4. Seleziona Invia.

   Quando il test ha esito positivo, il back-end risponde con 200 OK e alcuni dati.

Aggiungere altre API

È possibile comporre un'API fuori dalle API esposte da servizi diversi, tra cui:

• Una specifica OpenAPI
• Un'API SOAP
• Un’API GraphQL
• Un'app Web ospitata nel servizio app di Azure
• Funzioni di Azure
• App per la logica di Azure
• Azure Service Fabric

Per aggiungere un'API a un'API esistente:

1. Passare all'istanza di Gestione API di Azure nel portale di Azure:

   

2. Selezionare API nella pagina Panoramica o selezionare API> nel menu della barra laterale.

   

3. Selezionare i puntini di sospensione (...) accanto all'API a cui si vuole aggiungere un'altra API.

4. Selezionare Importa dal menu di scelta rapida:

   

5. Selezionare un servizio da cui importare un'API.

Contenuti correlati

• Limitazioni relative all'importazione di API
• Importare una specifica OpenAPI
• Importare un'API SOAP
• Importare un'API SOAP e convertirla in REST
• Importare un'API del Servizio app
• Importare un'API dell'app contenitore
• Importare un'API WebSocket
• Importare un'API GraphQL
• Importare uno schema di GraphQL e configurare resolver di campo
• Importare un'API dell'app per le funzioni
• Importare un'API per un'app di logica
• Importare un servizio Service Fabric
• Importare un'API Microsoft Foundry
• Importare un'API di OpenAI di Azure
• Importare un'API LLM
• Importare un'API OData
• Esportare un'API REST come server MCP
• Rendere visibile un server MCP esistente
• Importare un'API dell'agente A2A
• Importare metadati OData SAP
• Importare un'API gRPC
• Modificare un'API