Eseguire il proxy di un servizio SOAP

In questo tutorial imparerai a visualizzare un proxy API Edge in un servizio web basato su SOAP.

Questo tutorial illustra come generare una nuova API RESTful per il tuo servizio basato su SOAP. Sebbene non sia descritto in dettaglio qui, puoi anche generare un proxy passthrough che accetta un payload SOAP e lo passa al servizio di backend.

Che cosa ti serve

• Un account Apigee Edge. Se non ne hai ancora uno, puoi registrarti con le istruzioni riportate nella pagina relativa alla creazione di un account Apigee Edge.

Creazione del proxy in corso...

Qui dovrai fare in modo che Edge generi il proxy che risiederà di fronte a un servizio SOAP. Esistono due tipi di proxy API SOAP:

• Il tipo di proxy REST-SOAP-REST genera una nuova API RESTful con un livello di traduzione in SOAP. I client la chiamano come farebbero con altri servizi RESTful, passando i parametri di query necessari dal servizio di backend. Edge lo traduce nel payload SOAP previsto dal servizio.
• Il tipo di proxy proxy pass-through consente ai client di passare semplicemente un payload SOAP. Questo è un modo per far sì che le chiamate di servizio SOAP traggano vantaggio dalle funzionalità di gestione perimetrale.

Test del proxy in corso...

Per provare il proxy che hai creato, apri un prompt dei comandi e utilizza cURL. Digita il comando seguente, dove:

• ORG è il nome dell'organizzazione Edge in cui hai creato il proxy.
• ENV è l'ambiente in cui viene eseguito il deployment del proxy.
• DOMAIN corrisponde all'istanza Edge che stai utilizzando.

curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Ad esempio, se la tua organizzazione è docfood, l'ambiente è test e utilizzi il cloud Edge Enterprise, devi eseguire un comando come questo:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Se hai inserito GOOG per il parametro di query StockSymbol, dovresti ottenere il prezzo corrente per il titolo Alphabet Inc. di classe C. Ad esempio:

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

Ricevi la specifica OpenAPI generata automaticamente

Quando esegui il proxy per un servizio SOAP utilizzando "REST to SOAP to REST", Edge genera automaticamente una specifica OpenAPI. Puoi utilizzare la specifica OpenAPI per generare la documentazione dell'API per l'API.

Per ottenere le specifiche OpenAPI, visita questo URL:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

Crediti extra: come si fa a scoprire quali parametri di risorse, verbi e query utilizzare?

Nella chiamata API di test, hai utilizzato una risorsa e parametri di query specifici nella chiamata cURL al servizio SOAP di backend. Ma come fare a scoprirlo autonomamente?

Risorsa e verbo

Nella procedura guidata per il proxy dell'API, durante la creazione del proxy hai visto come le operazioni SOAP sarebbero state mappate ai verbi e alle risorse delle API. Tuttavia, se non li hai annotati, ecco come lo scopriresti dopo aver creato il proxy.

Nella scheda Sviluppo del proxy API, nel riquadro di navigazione a sinistra vedrai un elenco dei flussi sotto gli endpoint del proxy. Fai clic sul flusso che ti interessa. Ad esempio, il flusso GetQuote è un buon candidato. Quindi visualizza il codice XML nel riquadro Codice, che mostra il percorso della risorsa e il verbo per il flusso nell'elemento <Condition>: /quote e GET.

Parametri di ricerca

Con il flusso GetQuote selezionato, fai clic sul primo criterio nella visualizzazione grafica del flusso. Deve essere un criterio Estrai variabili che acquisisce i parametri di query che dovrebbero essere trasmessi: StockSymbol e LicenseKey. Se cerchi il servizio SOAP sul Web, ti viene indicato cosa passare per il codice LicenseKey.

I parametri di query acquisiti vengono salvati come variabili e utilizzati dal criterio successivo per creare il messaggio SOAP.