Udostępnij za pośrednictwem

Importowanie interfejsu API PROTOKOŁU SOAP do usługi API Management i konwertowanie go na interfejs REST

DOTYCZY: Wszystkie warstwy usługi API Management

W tym artykule pokazano, jak zaimportować interfejs API PROTOKOŁU SOAP jako specyfikację WSDL, a następnie przekonwertować go na interfejs API REST. Pokazano również, jak przetestować interfejs API w usłudze Azure API Management.

W tym artykule omówiono sposób wykonywania następujących zadań:

  • Importowanie interfejsu API SOAP i konwertowanie do REST
  • Testowanie interfejsu API w witrynie Azure Portal

Uwaga

Importowanie WSDL do usługi API Management podlega pewnym ograniczeniom. Pliki WSDL z dyrektywami wsdl:import, xsd:importi xsd:include nie są obsługiwane. Aby narzędzie typu open source rozpoznawało i scalało te zależności w pliku WSDL, zobacz to repozytorium GitHub.

Wymagania wstępne

Przechodzenie do wystąpienia usługi API Management

  1. W portalu Azure wyszukaj i wybierz usługi API Management.

    Zrzut ekranu przedstawiający usługi API Management w wynikach wyszukiwania.

  2. Na stronie usług API Management wybierz instancję API Management.

    Zrzut ekranu przedstawiający instancję zarządzania API na stronie usług zarządzania API.

Importowanie i publikowanie API backendowego

  1. W okienku po lewej stronie w sekcji Interfejsy API wybierz pozycję Interfejsy API.

  2. Na stronie interfejsów API wybierz opcję + Dodaj API.

  3. W obszarze Utwórz z definicji wybierz pozycję WSDL:

    Zrzut ekranu przedstawiający kafelek WSDL w witrynie Azure Portal.

  4. W specyfikacji WSDL wprowadź adres URL interfejsu API protokołu SOAP lub kliknij pozycję Wybierz plik, aby wybrać lokalny plik WSDL.

  5. W obszarze Metoda importu wybierz pozycję SOAP do interfejsu REST. Po wybraniu tej opcji usługa API Management próbuje dokonać automatycznej transformacji między xml i JSON. W takim przypadku konsumenci powinni wywołać interfejs API jako interfejs API RESTful, który zwraca kod JSON. Usługa API Management konwertuje każde żądanie na wywołanie protokołu SOAP.

    Zrzut ekranu przedstawiający opcję SOAP to REST.

  6. Pola Nazwa wyświetlana i Nazwa są wypełniane automatycznie informacjami z interfejsu API protokołu SOAP.

    Informacje o nazwie wyświetlanej, adresie URL i opisie są automatycznie wprowadzane dla operacji. Operacje otrzymują również nazwę wygenerowaną przez system.

  7. Wprowadź inne ustawienia interfejsu API, a następnie wybierz pozycję Utwórz. Te wartości można również skonfigurować później, przechodząc do karty Ustawienia .

    Aby uzyskać więcej informacji na temat ustawień interfejsu API, zobacz Importowanie i publikowanie pierwszego interfejsu API.

Testowanie nowego interfejsu API w witrynie Azure Portal

Operacje można wywoływać bezpośrednio z witryny Azure Portal. Ta metoda zapewnia wygodny sposób wyświetlania i testowania operacji interfejsu API.

  1. Wybierz interfejs API utworzony w poprzednim kroku.

  2. Wybierz kartę Test.

  3. Wybierz operację.

    Na stronie są wyświetlane pola parametrów zapytania i pól nagłówków. Jednym z nagłówków jest Ocp-Apim-Subscription-Key. Ten nagłówek dotyczy klucza subskrypcji produktu skojarzonego z tym interfejsem API. Jeśli utworzono wystąpienie usługi API Management, jesteś już administratorem, więc klucz jest wypełniany automatycznie.

  4. Wybierz Wyślij.

    Po pomyślnym zakończeniu testu zaplecze odpowiada komunikatem 200 OK i pewnymi danymi.

Dołączanie innych interfejsów API

Interfejs API można zbudować z API, które są udostępniane przez różne usługi, w tym:

  • Specyfikacja interfejsu OpenAPI
  • API SOAP
  • Interfejs API graphQL
  • Aplikacja internetowa hostowana w usłudze Azure App Service
  • Funkcje platformy Azure
  • Azure Logic Apps
  • Azure Service Fabric

Uwaga

Podczas importowania interfejsu API operacje są dołączane do bieżącego interfejsu API.

Aby dodać interfejs API do istniejącego:

  1. Przejdź do wystąpienia usługi Azure API Management w witrynie Azure Portal:

    Zrzut ekranu przedstawiający stronę usług API Management.

  2. Wybierz interfejsy API na stronie Przegląd lub wybierz interfejsy API>interfejsy API w menu po lewej stronie.

    Zrzut ekranu pokazujący wybór interfejsów API na stronie Przegląd.

  3. Wybierz wielokropek (...) obok interfejsu API, do którego chcesz dołączyć inny.

  4. Wybierz Importuj z menu rozwijanego:

    Zrzut ekranu przedstawiający polecenie Importuj.

  5. Wybierz usługę, z której chcesz zaimportować interfejs API.

Powiązana zawartość