Megosztás a következőn keresztül:


SOAP API importálása az API Managementbe

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

Ez a cikk bemutatja, hogyan importálhat WSDL-specifikációt, amely egy SOAP API szabványos XML-reprezentációja. A cikk azt is bemutatja, hogyan tesztelheti az API-t az API Managementben.

Ebben a cikkben az alábbiakkal ismerkedhet meg:

  • SOAP API importálása
  • Az API tesztelése az Azure Portalon

Feljegyzés

Az API Managementbe történő WSDL-importálásra bizonyos korlátozások vonatkoznak. A WSDL-fájlok és az wsdl:importxsd:importxsd:include irányelvek nem támogatottak. A függőségek WSDL-fájlban való feloldására és egyesítésére szolgáló nyílt forráskódú eszközökről ebben a GitHub-adattárban olvashat.

Előfeltételek

Háttér API importálása

  1. Az Azure Portalon keresse meg az API Management-példányt.

  2. A bal oldali menüben válassza az API-k>+ API hozzáadása lehetőséget.

  3. A Létrehozás definícióból csoportban válassza a WSDL lehetőséget.

    SOAP API

  4. A WSDL-specifikációban adja meg a SOAP API URL-címét, vagy kattintson a Fájl kiválasztása gombra egy helyi WSDL-fájl kiválasztásához.

  5. Az Importálási metódusban alapértelmezés szerint a SOAP-továbbítás van kiválasztva. Ezzel a kijelöléssel az API SOAP-ként jelenik meg, és az API-felhasználóknak SOAP-szabályokat kell használniuk. Ha REST API-t szeretne használni, kövesse a SOAP API importálását és REST-konvertálását ismertető szakasz lépéseit.

    SOAP API létrehozása WSDL-specifikációból

  6. Az alábbi API-beállítások automatikusan kitöltődnek a SOAP API információi alapján: Megjelenítendő név, Név, Leírás. A műveletek automatikusan meg lesznek töltve megjelenítendő névvel, URL-címmel és leírással, és rendszer által generált nevet kapnak.

  7. Adjon meg más API-beállításokat. A létrehozás során beállíthatja az értékeket, vagy később konfigurálhatja őket a Gépház lapon.

    Az API-beállításokról további információt az első API-oktatóanyag importálása és közzététele című témakörben talál.

  8. Válassza a Létrehozás lehetőséget.

Az új API tesztelése a portálon

A műveletek közvetlenül a portálról hívhatók meg, így a rendszergazdák kényelmesen megtekinthetik és tesztelhetik az API-k műveleteit.

  1. Válassza ki az előző lépésben létrehozott API-t.

  2. Kattintson a Teszt fülre.

  3. Válasszon ki egy művelet. Az oldalon megjelennek a lekérdezési paraméterek és a fejlécek mezői.

    Feljegyzés

    A tesztkonzolon az API Management automatikusan feltölt egy Ocp-Apim-Subscription-Key fejlécet, és konfigurálja a beépített teljes hozzáférésű előfizetés előfizetési kulcsát. Ez a kulcs lehetővé teszi az API Management-példány összes API-jának elérését. Az Ocp-Apim-Subscription-Key fejlécet igény szerint a HTTP-kérés melletti "szem" ikonra kattintva jelenítheti meg.

  4. A művelettől függően adja meg a lekérdezési paraméter értékeit, a fejlécértékeket vagy a kérelem törzsét. Válassza az Küldés lehetőséget.

    Ha a teszt sikeres, a háttérrendszer egy sikeres HTTP-válaszkóddal és néhány adattal válaszol.

    Tipp.

    Alapértelmezés szerint a tesztkonzol kérést küld az API Management CORS-proxyjának, amely továbbítja a kérést az API Management-példánynak, majd továbbítja azt a háttérrendszernek. Ez a proxy a 13.91.254.72 nyilvános IP-címet használja, és csak nyilvános végpontokat tud elérni. Ha közvetlenül a böngészőből szeretne kérést küldeni az API Management szolgáltatásnak, válassza a CORS-proxy megkerülése lehetőséget. Ezt a lehetőséget akkor használja, ha a tesztkonzolt szeretné használni, és az API Management-átjáró hálózati elkülönítésű, vagy nem engedélyezi a CORS-proxyból érkező forgalmat.

Az API-k hibakereséséhez tekintse meg az oktatóanyagot: Api-k hibakeresése kéréskövetés használatával.

Helyettesítő SOAP művelet

Ha olyan SOAP-kérést kell átadnia, amely nem rendelkezik dedikált műveletet definiált az API-ban, konfigurálhat helyettesítő SOAP-műveletet. A helyettesítő karakter művelet megegyezik az API-ban nem definiált SOAP-kéréssel.

Helyettesítő SOAP-művelet definiálása:

  1. A portálon válassza ki az előző lépésben létrehozott API-t.
  2. A Tervezés lapon válassza a + Művelet hozzáadása lehetőséget.
  3. Adja meg a művelet megjelenítendő nevét .
  4. Az URL-címben válassza ki POST és írja be /soapAction={any} az erőforrást. A kapcsos zárójelek sablonparamétere tetszőleges, és nem befolyásolja a végrehajtást.

Egyéb API-k hozzáfűzése

Különböző szolgáltatások által közzétett API-kat készíthet, többek között az alábbiakat:

  • OpenAPI-specifikáció
  • A SOAP API
  • A GraphQL API
  • A Azure-alkalmazás Service-ben üzemeltetett webalkalmazás
  • Azure-függvényalkalmazás
  • Azure Logic Apps
  • Azure Service Fabric

Fűzjön hozzá egy másik API-t a meglévő API-hoz az alábbi lépésekkel.

Feljegyzés

Egy másik API importálásakor a műveletek hozzáfűződnek az aktuális API-hoz.

  1. Nyissa meg az Azure API Management-példányát az Azure Portalon.

    Ugrás az Azure API Mgmt-példányra

  2. Válassza az API-kat az Áttekintés lapon vagy a bal oldali menüben.

    API-k kiválasztása

  3. Kattintson a ... elemre azon API mellett, amelyhez egy másik API-t szeretne hozzáfűzni.

  4. Válassza az Importálás elemet a legördülő menüből.

    Importálás kiválasztása

  5. Válasszon egy szolgáltatást, amelyből importálni fogja az API-t.

    Szolgáltatás kiválasztása

Következő lépések