Udostępnij za pośrednictwem

Importowanie aplikacji logiki jako interfejsu API

DOTYCZY: Wszystkie warstwy usługi API Management

W tym artykule pokazano, jak zaimportować aplikację logiki jako interfejs API i przetestować zaimportowany interfejs API.

Uwaga

Obecnie ta funkcja nie jest dostępna w obszarach roboczych.

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

  • Importowanie aplikacji logiki jako interfejsu API
  • Testowanie interfejsu API w witrynie Azure Portal

Uwaga

Usługa Azure API Management obsługuje automatyczne importowanie zasobu Logic App (Consumption), który działa w wielodostępnym środowisku Logic Apps. Aby uzyskać więcej informacji, zobacz Różnice między standardowymi, jednodzierżawczymi aplikacjami logiki a konsumpcyjnymi, wielodostępowymi aplikacjami logiki.

Wymagania wstępne

Importowanie i publikowanie API zaplecza

  1. Przejdź do usługi API Management w witrynie Azure Portal.

  2. W menu po lewej stronie w sekcji Interfejsy API wybierz pozycję Interfejsy API, a następnie wybierz pozycję + Dodaj interfejs API.

  3. Wybierz Logic App na liście Utwórz z zasobu Azure:

    Zrzut ekranu przedstawiający kafelek aplikacji logicznej.

  4. Wybierz pozycję Przeglądaj , aby wyświetlić listę aplikacji logiki, które mają wyzwalacz HTTP w subskrypcji. (Aplikacje logiki, które nie mają wyzwalacza HTTP, nie będą wyświetlane na liście).

    Zrzut ekranu przedstawiający przycisk Przeglądaj.

  5. Wybierz aplikację logiki:

    Zrzut ekranu pokazujący okno wyboru aplikacji logicznej do zaimportowania.

    Usługa API Management znajduje dokument struktury Swagger skojarzony z wybraną aplikacją, pobiera go i importuje.

  6. Dodaj sufiks adresu URL interfejsu API. Sufiks jednoznacznie identyfikuje interfejs API w wystąpieniu usługi API Management.

    Zrzut ekranu przedstawiający wartości wprowadzone w oknie Utwórz z aplikacji Logic App.

  7. Jeśli chcesz, aby interfejs API został opublikowany i dostępny dla deweloperów, przejdź do widoku Pełny i skojarz interfejs API z produktem. W tym przykładzie użyto produktu Unlimited . (Interfejs API można dodać do produktu podczas jego tworzenia lub później, za pomocą karty Ustawienia.)

    Uwaga

    Produkty to skojarzenia co najmniej jednego interfejsu API oferowanego deweloperom za pośrednictwem portalu deweloperów. Najpierw deweloperzy muszą subskrybować produkt, aby uzyskać dostęp do interfejsu API. Po zasubskrybowaniu otrzymują klucz subskrypcji dla dowolnego interfejsu API w produkcie. Jako twórca wystąpienia usługi API Management jesteś administratorem i domyślnie masz subskrypcję na każdy produkt.

    W niektórych warstwach każde wystąpienie usługi API Management zawiera dwa domyślne przykładowe produkty:

    • Rozrusznik
    • Unlimited (nieograniczony)

  8. Wprowadź inne ustawienia interfejsu API. Te wartości można ustawić podczas tworzenia interfejsu API lub nowszego, przechodząc do karty Ustawienia . Ustawienia zostały wyjaśnione w samouczku Importowanie i publikowanie pierwszego interfejsu API.

  9. Wybierz pozycję Utwórz.

Testowanie 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.

Zrzut ekranu przedstawiający kroki testowania interfejsu API.

  1. Wybierz interfejs API utworzony w poprzednim kroku.

  2. Na karcie Test wybierz operację, którą chcesz przetestować.

    • Na stronie są wyświetlane pola parametrów zapytania i nagłówków.
    • Jednym z nagłówków jest Ocp-Apim-Subscription-Key. Ten nagłówek dotyczy klucza subskrypcji produktu skojarzonego z interfejsem API.
    • Jako twórca wystąpienia usługi API Management jesteś administratorem, więc klucz jest wypełniany automatycznie.

  3. Wybierz Wyślij. Po pomyślnym zakończeniu testu serwer odpowiada 200 OK i 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 instancji usługi Azure API Management w 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.

Uwaga

Każda aplikacja logiki ma operację manual-invoke . Jeśli chcesz połączyć wiele aplikacji logiki w interfejsie API, musisz zmienić nazwę funkcji. Aby zmienić nazwę funkcji/interfejsu API, zmień wartość tytułu w edytorze specyfikacji interfejsu OpenAPI.

Powiązana zawartość