Импорт API SOAP в службу управления API

Статья
08/04/2023

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

В этой статье показано, как импортировать спецификацию WDSL, — стандартное XML-представление SOAP API. Также здесь показано, как протестировать программный интерфейс в службе "Управление API".

Вы узнаете, как выполнять следующие задачи:

Импорт SOAP API
проверка API на портале Azure;

Примечание.

Импорт WSDL в службу Управление API регулируется определенными ограничениями. WSDL-файлы с директивами wsdl:import, xsd:import и xsd:include не поддерживаются. Средство с открытым кодом для разрешения и объединения этих зависимостей в WSDL-файле см. в этом репозитории GitHub.

Необходимые компоненты

Экземпляр управления API. Если у вас еще нет одного, выполните следующее краткое руководство. Создайте экземпляр Azure Управление API.
Azure CLI
- Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.
- Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
  - Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.
  - Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.
  - Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.
Azure PowerShell
- Если вы решили использовать Azure PowerShell локально:
  - Установите последнюю версию модуля Az PowerShell.
  - Подключитесь к учетной записи Azure с помощью командлета Connect-AzAccount.
- Если вы решили использовать Azure Cloud Shell:
  - Дополнительные сведения см. в статье Общие сведения об Azure Cloud Shell.

Импорт внутреннего API

Перейдите к экземпляру Управления API на портале Azure.
В меню слева выберите API>+ Добавить API.
В разделе Создание из определения выберите WDSL.
В спецификации WSDL введите URL-адрес SOAP API или нажмите Выбрать файл, чтобы указать расположение локального WSDL-файла.
В качестве метода импорта по умолчанию выбрана сквозная передача SOAP. При выборе этого параметра API предоставляется как SOAP, а потребители API должны использовать правила протокола SOAP. Если нужно преобразовать API в REST, выполните инструкции из статьи Import a SOAP API and convert to REST (Импорт SOAP API и преобразование его в REST).
Следующие параметры API заполняются автоматически на основе сведений из API SOAP: отображаемое имя, имя, описание. Операции заполняются автоматически отображаемым именем, URL-адресом и описанием и получают системное имя.
Введите другие параметры API. Вы можете задать значения во время создания или настроить их позже, перейдя на вкладку Параметры.

Дополнительные сведения о настройках API-интерфейсов см. в обучающей статье Импорт и публикация первого API.
Нажмите кнопку создания.

В следующем примере используется команда импорта API api az api для импорта спецификации WSDL из указанного URL-адреса в экземпляр Управление API с именем apim-hello-world. Чтобы импортировать путь к спецификации вместо URL-адреса, используйте --specification-path параметр.

В этом примере WSDL имя службы — OrdersAPI, а одна из доступных конечных точек (интерфейсов) является базовой.

# API Management service-specific details
APIMServiceName="apim-hello-world"
ResourceGroupName="myResourceGroup"

# API-specific details
APIId="order-api"
APIPath="order"
SpecificationFormat="Wsdl"
SpecificationURL="https://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl"
WsdlServiceName="OrdersAPI"
WsdlEndpointName="basic"

# Import API
az apim api import --path $APIPath --resource-group $ResourceGroupName \
    --service-name $APIMServiceName --api-id $APIId \
    --specification-format $SpecificationFormat --specification-url $SpecificationURL \
    --wsdl-service-name $WsdlServiceName --wsdl-endpoint-name $WsdlEndpointName

В следующем примере используется командлет Import-AzApiManagementApi Azure PowerShell для импорта спецификации WSDL из указанного URL-адреса в экземпляр Управление API с именем apim-hello-world. Чтобы импортировать путь к спецификации вместо URL-адреса, используйте -SpecificationPath параметр.

В этом примере WSDL имя службы — OrdersAPI, а одна из доступных конечных точек (интерфейсов) является базовой.

# API Management service-specific details
$apimServiceName = "apim-hello-world"
$resourceGroupName = "myResourceGroup"

# API-specific det
$apiId = "orders-api"
$apiPath = "orders"
$specificationFormat = "Wsdl"
$specificationUrl = "https://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl"
$wsdlServiceName = "OrdersAPI"
$wsdlEndpointName = "basic"

# Get context of the API Management instance. 
$context = New-AzApiManagementContext -ResourceGroupName $resourceGroupName -ServiceName $apimServiceName

# Import API
Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $specificationFormat -SpecificationUrl $specificationUrl -Path $apiPath -WsdlServiceName $wsdlServiceName -WsdlEndpointName $wsdlEndpointName

Проверка нового API на портале

Операции можно вызывать непосредственно на портале, что позволяет администраторам просматривать и тестировать операции API.

Выберите API, созданный на предыдущем шаге.
Откройте вкладку Тест.
Выберите операцию. На странице отобразятся поля для параметров запроса и для заголовков.

Примечание.

В тестовой консоли Управление API автоматически заполняет заголовок Ocp-Apim-Subscription-Key и настраивает ключ подписки встроенной подписки. Этот ключ обеспечивает доступ к каждому API в Управление API экземпляре. При необходимости отобразится заголовок Ocp-Apim-Subscription-Key, щелкнув значок "глаз" рядом с HTTP-запросом.
В зависимости от операции введите значения параметров запроса, значения заголовков или текст запроса. Выберите Отправить.

При успешном выполнении теста серверная часть отвечает с помощью успешного кода ОТВЕТА HTTP и некоторых данных.

Совет

По умолчанию тестовая консоль отправляет запрос на прокси-сервер CORS Управление API, который перенаправляет запрос в экземпляр Управление API, который затем перенаправляет его в серверную часть. Этот прокси-сервер использует общедоступный IP-адрес 13.91.254.72 и может получать доступ только к общедоступным конечным точкам. Если вы хотите отправить запрос непосредственно из браузера в службу Управление API, выберите "Обход прокси CORS". Используйте этот параметр, если вы хотите использовать тестовую консоль, а шлюз Управление API изолирован от сети или не разрешает трафик из прокси-сервера CORS.

Сведения об отладке API см. в руководстве по отладке API с помощью трассировки запросов.

Действие SOAP с подстановочными знаками

Если необходимо передать запрос SOAP, который не имеет выделенного действия, определенного в API, можно настроить действие SOAP с подстановочными знаками. Действие с подстановочными знаками будет соответствовать любому запросу SOAP, который не определен в API.

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

На портале выберите API-интерфейс, созданный на предыдущем шаге.
На вкладке Конструктор выберите + Добавить операцию.
Введите значение Отображаемое имя для операции.
В поле URL-адреса выберите значение POST и введите /soapAction={any} в качестве ресурса. Параметр шаблона внутри фигурных скобок является произвольным и не влияет на выполнение.