Condividi tramite

Importare un'API SOAP in Gestione API 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:

  • Importare un'API SOAP e convertirla in REST
  • Testare l'API nel portale di Azure

Nota

L'importazione WSDL in Gestione API è soggetta a determinate limitazioni. I file WSDL con direttive wsdl:import, xsd:import e xsd:include non sono supportati. Per fare in modo che uno strumento open source risolva e unisca le dipendenze in un file WSDL, vedere questo repository GitHub.

Prerequisiti

Passare all'istanza di Gestione API

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

    Screenshot che mostra i servizi gestione API nei risultati della ricerca.

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

    Screenshot che mostra un'istanza di Gestione API nella pagina Servizi Gestione API.

Importare e pubblicare un'API back-end

  1. Nel riquadro sinistro, nella sezione API selezionare API.

  2. Nella pagina API selezionare + Aggiungi API.

  3. In Crea da definizione selezionare WSDL:

    Screenshot che mostra il riquadro WSDL nel portale di Azure.

  4. Nella specifica WSDL, immettere l'URL dell'API SOAP oppure fare clic su 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.

    Screenshot che mostra l'opzione SOAP to REST.

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

    Le informazioni relative a nome visualizzato, URL e Descrizione vengono immesse automaticamente per le operazioni. Le operazioni ricevono anche un nome generato dal sistema.

  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 la prima API.

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 è relativa alla chiave di abbonamento del prodotto associato a questa 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

Nota

Quando si importa un'API, le operazioni vengono aggiunte all'API corrente.

Per aggiungere un'API a un'API esistente:

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

    Screenshot che mostra la pagina Dei servizi gestione API.

  2. Selezionare API nella pagina Panoramica o selezionare API>nel menu a sinistra.

    Screenshot che mostra la selezione delle API nella pagina Panoramica.

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

  4. Selezionare Importa dal menu a discesa:

    Screenshot che mostra il comando Import.

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

Contenuti correlati