Поделиться через

Импорт API SOAP в управление API и преобразование его в REST

  • Статья

ПРИМЕНЯЕТСЯ КО ВСЕМ уровням управления API

В этой статье показано, как импортировать API SOAP в виде спецификации WSDL, а затем преобразовать его в REST API. В нем также показано, как протестировать API в службе "Управление API Azure".

В этой статье вы узнаете, как:

  • Импорт API SOAP и его преобразование в REST
  • проверка API на портале Azure;

Примечание.

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

Предварительные условия

Перейдите к вашему экземпляру управления API.

  1. На портале Azure найдите и выберите службы управления API:

    снимок экрана, на котором показаны службы управления API в результатах поиска.

  2. На странице управления API выберите ваш экземпляр службы управления API:

    снимок экрана, на котором показан экземпляр службы управления API на странице служб управления API.

Импорт и публикация API серверной части

  1. В левой области в разделе API выберите API.

  2. На странице API нажмите кнопку +Добавить API.

  3. В разделе "Создание из определения" выберите WSDL:

    Снимок экрана: плитка WSDL на портале Azure.

  4. В спецификации WSDL введите URL-адрес SOAP API или нажмите Выбрать файл, чтобы указать расположение локального WSDL-файла.

  5. В разделе Способ импорта выберите SOAP в формат REST. Если выбран этот параметр, в службе управления API выполняется попытка автоматического преобразования между XML и JSON. В этом случае потребителям рекомендуется вызывать API как RESTful API, который возвращает JSON. Управление API преобразует каждый запрос в вызов SOAP.

    Снимок экрана: параметр SOAP для REST.

  6. Поля отображаемого имени и имени заполняются автоматически данными из API SOAP.

    Отображаемое имя, URL-адрес и описание автоматически вводятся для операций. Операции также получают системное название.

  7. Введите другие параметры API и нажмите кнопку "Создать". Вы также можете настроить эти значения позже, перейдя на вкладку "Параметры ".

    Дополнительные сведения о параметрах API см. в статье "Импорт и публикация первого API".

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

Операции можно вызывать непосредственно на портале Azure. Этот метод предоставляет удобный способ просмотра и тестирования операций API.

  1. Выберите API, созданный на предыдущем шаге.

  2. Откройте вкладку Тест.

  3. Выберите операцию.

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

  4. Выберите Отправить.

    Если тест пройдет успешно, приложение серверной части передаст код ответа 200 — OK и некоторые данные.

Добавление других API

Вы можете создавать API из API, предоставляемых различными службами, в том числе:

  • Спецификация OpenAPI
  • A SOAP API
  • A GraphQL API
  • Веб-приложение, размещенное в службе приложений Azure
  • Функции Azure
  • Приложения логики Azure
  • Azure Service Fabric

Примечание.

При импорте API операции добавляются к текущему API.

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

  1. Перейдите к инстансу службы Управление API Azure на портале Azure.

    снимок экрана со страницей служб управления API.

  2. Выберите API на странице обзора или выберите API> в меню слева.

    снимок экрана, на котором показан выбор API на странице обзора.

  3. Выберите многоточие (...) рядом с API, к которому требуется добавить другой API.

  4. Выберите Импорт в раскрывающемся меню:

    снимок экрана, на котором показана команда импорта.

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

Связанный контент