Import rozhraní API SOAP do služby API Management a převod na REST

  • Článek

PLATÍ PRO: Všechny úrovně služby API Management

Tento článek ukazuje, jak importovat rozhraní API SOAP jako specifikaci WSDL a pak ho převést na rozhraní REST API. Tento článek také ukazuje, jak otestovat rozhraní API ve službě API Management.

V tomto článku získáte informace o těchto tématech:

  • Import rozhraní API protokolu SOAP a převod na REST
  • Testovat rozhraní API na portálu Azure Portal

Poznámka:

Import WSDL do služby API Management podléhá určitým omezením. Soubory WSDL s wsdl:import, xsd:importa xsd:include direktivy nejsou podporovány. Opensourcový nástroj pro překlad a sloučení těchto závislostí v souboru WSDL najdete v tomto úložišti GitHubu.

Požadavky

Projděte si následující rychlý start: Vytvoření instance služby Azure API Management

Přejít k instanci služby API Management

  1. Na webu Azure Portal vyhledejte a vyberte služby API Management.

    Výběr služeb API Management

  2. Na stránce služby API Management vyberte instanci služby API Management.

    Výběr instance služby API Management

Import a publikování back-endového rozhraní API

  1. V nabídce vlevo v části Rozhraní API vyberte rozhraní API> + Přidat rozhraní API.

  2. V části Vytvořit z definice vyberte WSDL.

    Rozhraní API protokolu SOAP

  3. Ve specifikaci WSDL zadejte adresu URL rozhraní SOAP API nebo vyberte vybrat soubor , který chcete vybrat místní soubor WSDL.

  4. V metodě Import vyberte SOAP na REST. Když vyberete tuto možnost, služba API Management se pokusí provést automatickou transformaci mezi XML a JSON. V tomto případě by uživatelé měli rozhraní API volat jako rozhraní RESTful API, které vrací JSON. Služba API Management převede každý požadavek na volání SOAP.

    SOAP do REST

  5. Následující pole se vyplní automaticky informacemi z rozhraní API SOAP: Zobrazovaný název, Název, Popis. Operace se vyplní automaticky zobrazovaným názvem, adresou URL a popisem a obdrží systémem vygenerovaný název.

  6. Zadejte další nastavení rozhraní API. Hodnoty můžete nastavit při vytváření nebo je později nakonfigurovat tak, že přejdete na kartu Nastavení.

    Další informace o nastavení rozhraní API najdete v tématu Import a publikování prvního kurzu rozhraní API .

  7. Vyberte Vytvořit.

Testování nového rozhraní API na webu Azure Portal

Operaci můžete volat přímo z portálu Azure Portal, který nabízí pohodlný způsob pro zobrazení a testování operací v rozhraní API.

  1. Vyberte rozhraní API, které jste vytvořili v předchozím kroku.

  2. Vyberte kartu Test.

  3. Vyberte operaci.

    Na stránce se zobrazují pole pro parametry dotazu a pole pro záhlaví. Jednou z hlaviček je klíč Ocp-Apim-Subscription-Key. Je to klíč pro přihlášení k odběru produktu, který je k tomuto rozhraní API přidružený. Pokud jste vytvořili instanci služby API Management, jste už správcem, takže klíč se vyplní automaticky.

  4. Stiskněte Odeslat.

    Pokud je test úspěšný, back-end odpoví s 200 OK a některými daty.

Připojení dalších rozhraní API

Můžete vytvořit rozhraní API rozhraní API vystavených různými službami, mezi které patří:

  • Specifikace OpenAPI
  • Rozhraní API SOAP
  • Rozhraní GraphQL API
  • Webová aplikace hostovaná ve službě Aplikace Azure Service
  • Aplikace funkcí Azure
  • Azure Logic Apps
  • Azure Service Fabric

Pomocí následujícího postupu připojte k existujícímu rozhraní API jiné rozhraní API.

Poznámka:

Při importu dalšího rozhraní API se k aktuálnímu rozhraní API připojí příslušné operace.

  1. Na webu Azure Portal přejděte do instance Azure API Management.

    Přejít do instance Mgmt rozhraní Azure API

  2. Na stránce Přehled nebo v nabídce vlevo vyberte rozhraní API.

    Výběr rozhraní API

  3. Klikněte na … vedle rozhraní API, ke kterému chcete připojit jiné rozhraní API.

  4. V rozevírací nabídce vyberte Importovat.

    Výběr importu

  5. Vyberte službu, ze které se má importovat rozhraní API.

    Výběr služby

Další kroky

Transformace a ochrana publikovaného rozhraní API