Eseguire il proxy di un servizio SOAP

In questo tutorial imparerai a posizionare un proxy API Edge davanti a un server web basato su SOAP completamente gestito di Google Cloud.

Questo tutorial illustra come generare una nuova API RESTful a fronte di un indirizzo IP completamente gestito di Google Cloud. 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 indicazioni stradali. alla pagina Creazione di un modello Apigee Account Edge.

Creazione del proxy in corso...

Qui farai in modo che Edge generi il proxy da posizionare 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 una traduzione lo strato SOAP. I client lo chiamano come gli altri servizi RESTful, passando la query i parametri richiesti 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. In questo modo, le chiamate ai servizi SOAP possono trarre 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 di seguito, dove:

• ORG è il nome dell'organizzazione Edge in cui hai creato il proxy.
• ENV è l'ambiente in cui viene eseguito il deployment del proxy.
• DOMINIO 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 stai utilizzando il cloud Edge Enterprise, eseguirai 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 la quotazione corrente delle azioni 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
      }
   }
}

Scaricare l'API OpenAPI generata automaticamente Specifiche

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

Per ottenere la specifica OpenAPI, visita semplicemente questo URL:

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

Crediti aggiuntivi: come scopri quali risorse, verbi e parametri di query usare?

Nella chiamata API di prova, hai utilizzato una risorsa e parametri di query specifici nella chiamata cURL al servizio SOAP di backend. Ma come si fa a scoprirlo da soli?

Risorsa e verbo

Nella procedura guidata del proxy API durante la creazione del proxy, hai visto come le operazioni SOAP viene mappato ai verbi e alle risorse dell'API. Ma se non le scrivessi, ecco come potresti scoprilo dopo la creazione del proxy.

Nella scheda Sviluppo del proxy API, nel riquadro di navigazione a sinistra vedrai una dei flussi all'interno degli endpoint proxy. Fai clic sul flusso che ti interessa. Ad esempio: il flusso GetQuote è una buona candidata. Quindi visualizza il file XML nel riquadro Codice, che mostra il percorso della risorsa e il verbo per il flusso in <Condition> : /quote e GET.

Parametri di query

Con il flusso GetQuote selezionato, fai clic sul primo criterio nella vista del flusso. Deve essere un criterio Estrai variabili che acquisisce i parametri di query che sono dovrebbe essere superato: StockSymbol e LicenseKey. (Se utilizzi un server web cerca il servizio SOAP, ti dice cosa passare per LicenseKey.

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