Proxy dla SOAP

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

Ten samouczek pokazuje, jak wygenerować nowy interfejs API typu REST przed interfejsem SOAP posprzedażna. Chociaż nie zostało to szczegółowo tutaj opisane, możesz też wygenerować przekazujący serwer proxy który akceptuje ładunek SOAP i przekazuje go do usługi backendu.

Czego potrzebujesz

• Konto Apigee Edge. Jeśli jeszcze go nie masz, możesz się zarejestrować, korzystając ze wskazówek dojazdu o tworzeniu Apigee Konto Edge.

Tworzę serwer proxy

Edge generuje serwer proxy, który będzie znajdować się przed usługą SOAP. Istnieją 2 typy serwerów proxy SOAP API:

• Typ serwera proxy REST-SOAP-REST generuje nowy interfejs API RESTful z tłumaczeniem do SOAP. Klienty wywołują je tak samo jak inne usługi REST, przekazując zapytanie parametrów wymaganych przez usługę backendu. Edge przekłada to na ładunek SOAP jest oczekiwana przez usługę.
• Przekazujący serwer proxy umożliwia klientom po prostu przekazywanie ładunku SOAP. Dzięki temu wywołania usługi SOAP mogą korzystać z funkcji zarządzania brzegiem.

Testowanie serwera proxy

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

• ORG to nazwa organizacji Edge, w której został utworzony serwer proxy.
• ENV to środowisko, w którym jest wdrożony serwer proxy.
• DOMENA odpowiada używanej przez Ciebie 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 Edge Enterprise Cloud, uruchom polecenie w rodzaju: to:

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

Jeśli w parametrze zapytania StockSymbol wpiszesz GOOG, otrzymasz aktualną cenę 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 wygenerowany interfejs OpenAPI Specyfikacja

Jeśli korzystasz z serwera proxy usługi SOAP za pomocą polecenia „REST to SOAP to REST”, Edge automatycznie generuje Specyfikację OpenAPI. Za pomocą Specyfikacja OpenAPI do generowania dokumentacji API dla interfejsu API.

Aby uzyskać specyfikację OpenAPI, po prostu otwórz ten URL:

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

Dodatkowe informacje: jak dowiesz się, których zasobów, czasowników i parametrów zapytania użyć?

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

Zasób i czasownik

Podczas tworzenia serwera proxy w kreatorze serwera proxy interfejsu API można było zobaczyć, jak operacje SOAP będzie mapowana na czasowniki i zasoby API. Jeśli jednak ich nie zapisałeś, możesz to zrobić w następujący sposób: możesz dowiedzieć się więcej po utworzeniu serwera proxy.

Na karcie Programowanie serwera proxy interfejsu API w lewym panelu nawigacji zobaczysz listę przepływów w sekcji punktów końcowych serwera proxy. Kliknij przepływ, który Cię interesuje. Przykład: Możesz skorzystać z procedury GetQuote. Następnie wyświetl kod XML w panelu kodu, który wskazuje ścieżkę zasobu i czasownik dla przepływu w <warunek> element: /quote i GET.

Parametry zapytania

Po wybraniu procesu GetQuote, kliknij pierwszą zasadę w widoku z widokiem przepływu. Powinna to być zasada Wyodrębnianie zmiennych, która przechwytuje parametry zapytania, które są powinny zostać zaliczone: StockSymbol i LicenseKey. (Jeśli zrobisz to w internecie i wyszuka usługę SOAP, zostanie wyświetlona informacja, co należy przekazać dla klucza LicenseKey).

Przechwycone parametry zapytania są zapisywane jako zmienne i używane przez następną zasadę do: i utworzyć komunikat SOAP.