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.

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 API Management obsługuje automatyczne importowanie zasobu aplikacji logiki (zużycie). które działa w środowisku usługi Logic Apps z wieloma dzierżawami. Dowiedz się więcej na temat usługi Logic Apps z jedną dzierżawą i wieloma dzierżawami.

Wymagania wstępne

Przechodzenie do wystąpienia usługi API Management

  1. W witrynie Azure Portal wyszukaj i wybierz pozycję Usługi API Management.

    Wybieranie usług API Management

  2. Na stronie Usługi API Management wybierz wystąpienie usługi API Management.

    Wybieranie wystąpienia usługi API Management

Importowanie i publikowanie interfejsu API zaplecza

  1. Przejdź do usługi API Management w witrynie Azure Portal i wybierz z menu pozycję Interfejsy API.

  2. Wybierz pozycję Aplikacja logiki z listy Dodaj nowy interfejs API.

    Wybierz kategorię aplikacji logiki

  3. Naciśnij przycisk Przeglądaj , aby wyświetlić listę usługi Logic Apps z wyzwalaczem HTTP w subskrypcji.

    • Aplikacje logiki bez wyzwalacza HTTP nie będą wyświetlane na liście.

    Przeglądaj istniejące aplikacje logiki z prawidłowym wyzwalaczem

  4. Wybierz aplikację logiki.

    Wybieranie aplikacji logiki

  5. Usługa API Management znajduje program Swagger skojarzony z wybraną aplikacją, pobiera ją i importuje.

  6. Dodaj sufiks adresu URL interfejsu API.

    • Sufiks jednoznacznie identyfikuje ten konkretny interfejs API w tym wystąpieniu usługi API Management.

    Kończenie pól

  7. Jeśli chcesz, aby interfejs API został opublikowany i dostępny dla deweloperów, przełącz się do widoku Pełny i skojarz go z produktem. W tym przykładzie używamy produktu "Unlimited".

    • Interfejs API można dodać do produktu podczas tworzenia lub nowszego 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 tym produkcie. Jako twórca wystąpienia usługi API Management jesteś administratorem i domyślnie subskrybujesz każdy produkt.

    Każde wystąpienie usługi API Management zawiera dwa domyślne przykładowe produkty:

    • Starter (początkowy)
    • Unlimited (nieograniczony)
  8. Wprowadź inne ustawienia interfejsu API.

    • Te wartości można ustawić podczas tworzenia lub później, 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 mogą być wywoływane bezpośrednio z witryny Azure Portal, która zapewnia wygodny sposób wyświetlania i testowania operacji interfejsu API.

Testowanie aplikacji logicznej

  1. Wybierz interfejs API utworzony w poprzednim kroku.

  2. Naciśnij kartę Test.

  3. 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" dla klucza subskrypcji produktu skojarzonego z tym interfejsem API.
    • Jako twórca wystąpienia usługi API Management jesteś już administratorem, więc klucz jest wypełniany automatycznie.
  4. Kliknij pozycję Wyślij.

    • Po pomyślnym zakończeniu testu zaplecze odpowiada na 200 OK i dane.

Dołączanie innych interfejsów API

Możesz utworzyć interfejs API interfejsów API udostępnianych przez różne usługi, w tym:

  • Specyfikacja interfejsu OpenAPI
  • Interfejs API PROTOKOŁU SOAP
  • Interfejs API graphQL
  • Aplikacja internetowa hostowana w usłudze aplikacja systemu Azure
  • Aplikacja funkcji platformy Azure
  • Azure Logic Apps
  • Azure Service Fabric

Dołącz inny interfejs API do istniejącego interfejsu API, wykonując następujące kroki.

Uwaga

Po zaimportowaniu innego interfejsu API operacje są dołączane do bieżącego interfejsu API.

  1. Przejdź do wystąpienia Azure API Management w Azure Portal.

    Przejdź do wystąpienia narzędzia Mgmt interfejsu API platformy Azure

  2. Wybierz pozycję Interfejsy API na stronie Przegląd lub z menu po lewej stronie.

    Wybierz interfejsy API

  3. Kliknij przycisk ... obok interfejsu API, który chcesz dołączyć do innego interfejsu API.

  4. Z menu rozwijanego wybierz pozycję Importuj.

    Wybieranie opcji importu

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

    Wybieranie usługi

Uwaga

Każda aplikacja logiki ma operację manual-invoke. Aby składać się z interfejsu API wielu aplikacji logiki i uniknąć kolizji, musisz zmienić nazwę funkcji. Aby zmienić nazwę funkcji/interfejsu API, przejdź do edytora specyfikacji interfejsu OpenAPI i zmień wartość tytułu.

Następne kroki