SOAP API importálása az API Managementbe, és konvertálás REST-vé

Cikk
04/04/2024

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

Ez a cikk bemutatja, hogyan importálhat egy SOAP API-t WSDL-specifikációként, majd konvertálhatja REST API-vá. 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 és konvertálása REST-té
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

Végezze el a következő rövid útmutatót: Azure API Management-példány létrehozása

Nyissa meg az API Management-példányát

Az Azure Portalon keresse meg és válassza ki az API Management-szolgáltatásokat.
Az API Management-szolgáltatások lapon válassza ki az API Management-példányt.

Háttérrendszeri API importálása és közzététele

A bal oldali menü API-k szakaszában válassza az API-k>+ API hozzáadása lehetőséget.
A Létrehozás definícióból csoportban válassza a WSDL lehetőséget.
A WSDL specifikációjában adja meg a SOAP API URL-címét, vagy válassza a Fájl kiválasztása lehetőséget egy helyi WSDL-fájl kiválasztásához.
Az Importálási módszerben válassza a SOAP to REST lehetőséget. Ha ezt a beállítást választja, az API Management megpróbálja automatikusan átalakítani az XML és a JSON között. Ebben az esetben a felhasználóknak RESTful API-ként kell meghívni az API-t, amely JSON-t ad vissza. Az API Management minden kérést SOAP-hívássá alakít át.
A rendszer automatikusan kitölti a következő mezőket a SOAP API információival: 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.
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.
Válassza a Létrehozás lehetőséget.

Az új API tesztelése az Azure Portalon

A műveleteket meg lehet hívni közvetlenül az Azure Portalról, ami kényelmes módot biztosít az API műveleteinek megtekintésére és tesztelésére.

Válassza ki az előző lépésben létrehozott API-t.
Kattintson a Teszt fülre.
Válasszon ki egy művelet.

A lapon a lekérdezési paraméterek és a fejlécek mezői láthatók. Az egyik fejléc az Ocp-Apim-Subscription-Key, amely az ehhez az API-hoz társított termék előfizetési kulcsára vonatkozik. Ha létrehozta az API Management-példányt, ön már rendszergazda, így a kulcs automatikusan ki lesz töltve.
Kattintson a Küldés gombra.

Ha a teszt sikeres, a háttérrendszer 200 OK-val és néhány adattal válaszol.

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.

Nyissa meg az Azure API Management-példányát az Azure Portalon.
Válassza az API-kat az Áttekintés lapon vagy a bal oldali menüben.
Kattintson a ... elemre azon API mellett, amelyhez egy másik API-t szeretne hozzáfűzni.
Válassza az Importálás elemet a legördülő menüből.
Válasszon egy szolgáltatást, amelyből importálni fogja az API-t.