Proxy eines SOAP-Dienstes

In dieser Anleitung erfahren Sie, wie Sie einen Edge API-Proxy vor einem SOAP-basierten Web platzieren. .

In dieser Anleitung erfahren Sie, wie Sie eine neue RESTful API vor Ihrer SOAP-basierten API generieren. . Auch wenn dies hier nicht im Detail beschrieben wird, können Sie auch einen Passthrough-Proxy generieren. die eine SOAP-Nutzlast akzeptiert und an den Back-End-Dienst übergibt.

Voraussetzungen

• Ein Apigee Edge-Konto. Falls Sie noch keins haben, können Sie sich mit der Anleitung für unter Apigee erstellen Edge-Konto.

Proxy erstellen

Hier lassen Sie Edge den Proxy generieren, der vor einem SOAP-Dienst platziert wird. Es gibt zwei Arten von SOAP API-Proxys:

• REST-SOAP-REST generiert eine neue RESTful API mit einer Übersetzung zu SOAP hinzufügen. Clients rufen sie wie andere RESTful-Dienste auf und übergeben dabei die Abfrage Parameter, die vom Back-End-Dienst benötigt werden. Edge übersetzt dies in die SOAP-Nutzlast die vom Dienst erwartet werden.
• Passthrough-Proxy ermöglicht es Clients, einfach eine SOAP-Nutzlast zu übergeben. Dies ist eine Möglichkeit, damit SOAP-Dienstaufrufe von Edge-Managementfunktionen profitieren.

Proxy testen

Um den von Ihnen erstellten Proxy zu testen, öffnen Sie eine Eingabeaufforderung und verwenden Sie cURL. Geben Sie den Befehl unten, wobei gilt:

• ORG ist der Name der Edge-Organisation, in der Sie den Proxy erstellt haben.
• ENV ist die Umgebung, in der der Proxy bereitgestellt wird.
• DOMAIN entspricht der von Ihnen verwendeten Edge-Instanz.

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

Wenn Ihre Organisation beispielsweise docfood ist, ist die Umgebung test verwenden und die Edge Enterprise-Cloud verwenden, führen Sie einen Befehl wie dies:

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

Wenn Sie für den Suchparameter „StockSymbol“ GOOG eingegeben haben, erhalten Sie der aktuelle Kurs der Klasse C-Aktie von Alphabet Inc. Beispiel:

{  
   "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
      }
   }
}

Automatisch generierte OpenAPI abrufen Spezifikation

Wenn Sie einen Proxy für einen SOAP-Dienst mit "REST to SOAP to REST" verwenden, Edge generiert automatisch Eine OpenAPI-Spezifikation. Sie können die OpenAPI-Spezifikation zum Generieren der API-Dokumentation für die API.

Die OpenAPI-Spezifikation können Sie unter folgender URL abrufen:

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

Zusätzliches Guthaben: So Finden Sie heraus, welche Ressourcen-, Verb- und Abfrageparameter verwendet werden sollen?

Im Test-API-Aufruf haben Sie eine bestimmte Ressource und bestimmte Abfrageparameter in Ihrem cURL-Aufruf verwendet Back-End-SOAP-Dienst. Aber wie würden Sie das selbst herausfinden?

Ressource und Verb

Im API-Proxy-Assistenten haben Sie bei der Erstellung des Proxys gesehen, wie die SOAP-Vorgänge API-Verben und Ressourcen zugeordnet. Aber wenn Sie diese nicht aufgeschrieben hätten, nachdem der Proxy erstellt wurde.

Auf dem Tab Develop des API-Proxys wird im linken Navigatorbereich ein Liste der Abläufe unter den Proxy-Endpunkten. Klicken Sie auf den gewünschten Ablauf. Beispiel: GetQuote-Ablauf eignet sich gut. Sehen Sie sich dann die XML-Datei im Code-Bereich an. das den Ressourcenpfad und das Verb für den Fluss in der <Condition> : /quote und GET.

Abfrageparameter

Klicken Sie bei ausgewähltem GetQuote-Vorgang auf die erste Richtlinie in der grafischen Ablaufansicht. Es sollte eine Richtlinie zum Extrahieren von Variablen sein, die Abfrageparameter erfasst, die erwartete Übergaben: StockSymbol und LicenseKey. (Wenn Sie eine suchen Sie nach dem SOAP-Dienst, wird Ihnen mitgeteilt, was Sie als LicenseKey übergeben müssen.)

Die erfassten Abfrageparameter werden als Variablen gespeichert und von der nächsten Richtlinie verwendet, um Erstellen der SOAP-Nachricht