Proxy dla SOAP

Z tego samouczka dowiesz się, jak umieścić serwer proxy interfejsu Edge API przed usługą internetową opartą na SOAP.

W tym samouczku pokazujemy, jak wygenerować nowy interfejs API typu REST na potrzeby usługi opartej na SOAP. Choć nie został on szczegółowo opisany, możesz też wygenerować przekazujący serwer proxy, który będzie przyjmować ładunek SOAP i przekazywać go do usługi backendu.

Czego potrzebujesz

• konto Apigee Edge. Jeśli jeszcze go nie masz, możesz się zarejestrować zgodnie z instrukcjami na stronie Tworzenie konta Apigee Edge.

Tworzę serwer proxy

W tym narzędziu Edge wygenerujesz serwer proxy, który będzie znajdować się przed usługą SOAP. Istnieją dwa typy serwerów proxy interfejsu SOAP API:

• Typ serwera proxy REST-SOAP-REST generuje nowy interfejs API typu REST z warstwą translacji dla SOAP. Klienty nazywają ją tak samo jak inne usługi REST, przekazując parametry zapytań wymagane przez usługę backendu. Edge przekształca je na ładunek SOAP oczekiwany przez usługę.
• Przejściowy serwer proxy umożliwia klientom po prostu przekazywanie ładunku SOAP. W ten sposób wywołania usługi SOAP mogą korzystać z funkcji zarządzania brzegiem.

Testowanie serwera proxy

Aby wypróbować utworzony przez siebie serwer proxy, otwórz wiersz polecenia i użyj cURL. Wpisz poniższe polecenie, gdzie:

• ORG to nazwa organizacji Edge, w której został utworzony serwer proxy.
• ENV to środowisko, w którym wdrażany jest serwer proxy.
• Domena {6/} odpowiada używanej instancji Edge.

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

Jeśli na przykład Twoja organizacja to docfood, środowisko to test i używasz chmury biznesowej Edge, uruchom następujące polecenie:

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

Jeśli dla parametru zapytania StockSymbol wpisano GOOG, powinna zostać wyświetlona aktualna cena akcji Alphabet Inc. klasy C. Na przykład:

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

Pobierz automatycznie wygenerowaną specyfikację OpenAPI

Gdy udostępniasz usługę SOAP za pomocą polecenia „REST to SOAP to REST”, Edge automatycznie generuje specyfikację OpenAPI. Możesz użyć specyfikacji OpenAPI, aby wygenerować dokumentację API dla tego interfejsu.

Aby pobrać specyfikację OpenAPI, odwiedź po prostu ten adres URL:

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

Dodatkowy udział: Jak sprawdzić, których zasobów, czasowników i parametrów zapytania należy użyć?

W testowym wywołaniu interfejsu API użyto określonych parametrów zasobu i zapytania w wywołaniu cURL usługi SOAP backendu. Ale jak możesz to sprawdzić?

Zasób i czasownik

W kreatorze proxy interfejsu API podczas tworzenia serwera proxy zobaczyliśmy, jak operacje SOAP będą mapowane na czasowniki i zasoby interfejsu API. Jeśli jednak ich nie masz, w ten sposób możesz sprawdzić, jak to zrobić po utworzeniu serwera proxy.

Na karcie Develop (Programowanie) serwera proxy interfejsu API, w panelu nawigacji po lewej stronie zobaczysz listę przepływów w obszarze Punkty końcowe serwera proxy. Kliknij proces, który Cię interesuje. Dobrym przykładem jest proces GetQuote. Następnie wyświetl w panelu kodu kod XML, który zawiera ścieżkę i czasownik do zasobu przepływu w elemencie <Condition>: /quote i GET.

Parametry zapytania

Po wybraniu przepływu GetQuote kliknij pierwszą zasadę w graficznym widoku przepływu. Powinna to być zasada Wyodrębnianie zmiennych, która przechwytuje parametry zapytania, które powinny być przekazywane: StockSymbol i LicenseKey. Jeśli wyszukasz w internecie usługę SOAP, dowiesz się, jakie dane należy przekazać dla klucza LicenseKey.

Przechwycone parametry zapytania są zapisywane jako zmienne i używane przez następną zasadę do utworzenia komunikatu SOAP.