Прокси службы SOAP

В этом руководстве вы узнаете, как разместить прокси-сервер Edge API перед веб-службой на основе SOAP.

В этом руководстве показано, как создать новый RESTful API для вашей службы на основе SOAP. Хотя здесь это подробно не описано, вы также можете создать сквозной прокси-сервер, который принимает полезную нагрузку SOAP и передает ее внутренней службе.

Что вам понадобится

• Учетная запись Apigee Edge. Если у вас его еще нет, вы можете зарегистрироваться, следуя инструкциям в разделе «Создание учетной записи Apigee Edge» .

Создание прокси

Здесь Edge сгенерирует прокси-сервер, который будет находиться перед службой SOAP. Существует два типа прокси-серверов SOAP API:

• Тип прокси-сервера REST-SOAP-REST создает новый RESTful API с уровнем трансляции в SOAP. Клиенты вызывают его так же, как и другие службы RESTful, передавая параметры запроса, необходимые внутренней службе. Edge преобразует это в полезную нагрузку SOAP, ожидаемую службой.
• Тип сквозного прокси-сервера позволяет клиентам просто передавать полезную нагрузку SOAP. Это способ использовать преимущества функций управления Edge при вызовах службы SOAP.

Тестирование прокси

Чтобы опробовать созданный вами прокси, откройте командную строку и используйте cURL. Введите команду ниже, где:

• ORG — это имя организации Edge, в которой вы создали прокси.
• ENV — это среда, в которой развернут прокси.
• DOMAIN соответствует используемому вами экземпляру Edge.

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

Например, если ваша организация — docfood , среда — test и вы используете корпоративное облако Edge, вы должны выполнить такую ​​команду:

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

Если вы ввели GOOG в качестве параметра запроса StockSymbol, вы должны получить текущую цену на акции Alphabet Inc. класса C. Например:

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

Получите автоматически созданную спецификацию OpenAPI.

Когда вы проксируете службу SOAP, используя «REST to SOAP to REST», Edge автоматически генерирует спецификацию OpenAPI . Вы можете использовать спецификацию OpenAPI для создания документации API для API.

Чтобы получить спецификацию OpenAPI, просто посетите этот URL:

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

Дополнительный балл: как узнать, какой ресурс, команду и параметры запроса использовать?

В тестовом вызове API вы использовали определенный ресурс и параметры запроса в вызове cURL к серверной службе SOAP. Но как узнать это самостоятельно?

Ресурс и глагол

В мастере прокси-сервера API при создании прокси-сервера вы видели, как операции SOAP будут сопоставляться с командами и ресурсами API. Но если вы их не записали, вот как вы это узнаете после создания прокси.

На вкладке «Разработка» прокси-сервера API в левой панели навигатора вы увидите список потоков в разделе «Конечные точки прокси». Щелкните интересующий вас поток. Например, поток GetQuote является хорошим кандидатом. Затем просмотрите XML на панели «Код», где показаны путь к ресурсу и команда для потока в элементе <Condition>: /quote и GET .

Параметры запроса

Выбрав поток GetQuote , щелкните первую политику в графическом представлении потока. Это должна быть политика извлечения переменных, которая фиксирует параметры запроса, которые, как ожидается, будут переданы: StockSymbol и LicenseKey . (Если вы выполните поиск службы SOAP в Интернете, он сообщит вам, что передать в качестве LicenseKey.)

Захваченные параметры запроса сохраняются как переменные и используются следующей политикой для создания сообщения SOAP.