Eseguire il proxy di un servizio SOAP

In questo tutorial imparerai a inserire un proxy API Edge davanti a un servizio web basato su SOAP.

Questo tutorial illustra come generare una nuova API RESTful davanti al servizio basato su SOAP. Sebbene non sia descritto in dettaglio qui, puoi anche generare un proxy pass-through 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 seguendo le istruzioni riportate in Creazione di un account Apigee Edge.

Creazione del proxy

Qui, Edge genererà il proxy che si troverà davanti 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 lo chiamano come farebbero con altri servizi RESTful, passando i parametri di query richiesti dal servizio di backend. Edge li traduce nel payload SOAP previsto dal servizio.
• Il tipo di proxy pass-through consente ai client di passare semplicemente un payload SOAP. In questo modo, le chiamate ai servizi SOAP possono usufruire delle funzionalità di gestione di Edge.

Test del proxy

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

• ORG è il nome dell'organizzazione Edge in cui hai creato il proxy.
• ENV è l'ambiente in cui è stato 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 aziendale Edge, esegui un comando simile al seguente:

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 attuale delle azioni di Alphabet Inc. 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
      }
   }
}

Recuperare la specifica OpenAPI generata automaticamente

Quando generi il proxy di 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 ottenere la specifica OpenAPI, visita questo URL:

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

Approfondimento: come faccio a scoprire quali risorse, verbi e parametri di 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 faresti a scoprirlo da solo?

Risorsa e verbo

Nella procedura guidata del proxy API, durante la creazione del proxy, hai visto come le operazioni SOAP vengono mappate ai verbi e alle risorse API. Ma se non li hai annotati, ecco come puoi scoprirli dopo la creazione del proxy.

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

Parametri di query

Con il flusso GetQuote selezionato, fai clic sul primo criterio nella visualizzazione del flusso grafico Dovrebbe trattarsi di un criterio Estrai variabili che acquisisce i parametri di query che devono essere passati: StockSymbol e LicenseKey. (Se cerchi il servizio SOAP sul web, ti viene indicato cosa passare per LicenseKey.)

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