Sdílet prostřednictvím

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

PLATÍ PRO: Veškeré ú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. Ukazuje také, jak otestovat rozhraní API ve službě Azure API Management.

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

  • Import rozhraní SOAP API a jeho 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

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

  1. Na portálu Azure vyhledejte a vyberte služby API Management:

    Snímek obrazovky zobrazící služby API Management ve výsledcích hledání

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

    snímek obrazovky znázorňující instanci služby API Management na stránce služeb API Management

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

  1. V levém podokně v části Rozhraní API vyberte rozhraní API.

  2. Na stránce rozhraní API vyberte + Přidat rozhraní API.

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

    Snímek obrazovky znázorňující dlaždici WSDL na webu Azure Portal

  4. Ve specifikaci WSDL zadejte adresu URL rozhraní SOAP API nebo klikněte na vybrat soubor a vyberte místní soubor WSDL.

  5. V části Metoda importu 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.

    Snímek obrazovky znázorňující možnost SOAP na REST

  6. Pole Zobrazovaný název a název se vyplní automaticky informacemi z rozhraní SOAP API.

    Zobrazovaný název, adresa URL a popis se zadávají automaticky pro operace. Operace také obdrží systémem vygenerovaný název.

  7. Zadejte další nastavení rozhraní API a pak vyberte Vytvořit. Tyto hodnoty můžete později nakonfigurovat také tak, že přejdete na kartu Nastavení .

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

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

Operace můžete používat přímo z Azure Portálu. Tato metoda poskytuje pohodlný způsob zobrazení a testování operací 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 Ocp-Apim-Subscription-Key. Tato hlavička je určená pro klíč předplatného produktu přidruženého k tomuto rozhraní API. Pokud jste vytvořili instanci služby API Management, jste už správcem, takže klíč se vyplní automaticky.

  4. Vyberte 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 z rozhraní API, která jsou poskytovaná různými službami, včetně:

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

Poznámka:

Při importu rozhraní API se operace připojí k aktuálnímu rozhraní API.

Připojení API k existujícímu API:

  1. Na webu Azure Portal přejděte do své instance služby Azure API Management:

    snímek obrazovky se stránkou služby API Management

  2. Na stránce přehledu vyberte rozhraní API nebo v nabídce vlevo vyberte rozhraní API>.

    Snímek obrazovky znázorňující výběr rozhraní API na stránce Přehled

  3. Vyberte ikonu se třemi tečkami (...) vedle rozhraní API, k němuž chcete přidat další rozhraní API.

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

    Snímek obrazovky s příkazem Importovat

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

Související obsah

  • Last updated on