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

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

A következőkre vonatkozik: Az összes 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á. Azt is bemutatja, hogyan tesztelheti az API-t az Azure API Managementben.

Ebben a cikkben az alábbiakkal ismerkedhet meg:

  • SOAP API importálása és restté alakítá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

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

  1. Az Azure portálonkeresse meg és válassza ki a API Management szolgáltatásokat:

    képernyőkép, amely az API Management-szolgáltatásokat jeleníti meg a keresési eredmények között.

  2. Az API Management-szolgáltatások lapon válassza ki az API Management-példányt:

    Képernyőkép, amely egy API Management-példányt jelenít meg az API Management szolgáltatások lapján.

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

  1. A bal oldali panel API-k szakaszában válassza API-klehetőséget.

  2. Az API-k lapon válassza a + API hozzáadásalehetőséget.

  3. A Létrehozás definícióból területen válassza a WSDL-t:

    Képernyőkép, amelyen az Azure Portal WSDL csempéje látható.

  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 módszerterületen válassza SOAP to RESTlehető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.

    KÉPERNYŐKÉP, amely a SOAP to REST beállítást jeleníti meg.

  6. A Megjelenítendő név és Név mezők automatikusan meg vannak töltve a SOAP API-ból származó információkkal.

    Megjelenítendő név, URL-és Leírás adatok automatikusan kitöltésre kerülnek a műveletekhez. A rendszer által létrehozott Név-t a műveletek is megkapják.

  7. Adjon meg más API-beállításokat, majd válassza a Létrehozás lehetőséget. Ezeket az értékeket később is konfigurálhatja a Beállítások lapon.

    További információ az API-beállításokról: Az első API-importálása és közzététele.

Az új API tesztelése az Azure Portalon

Az Azure Portalról közvetlenül meghívhat műveleteket. Ez a módszer kényelmes módot biztosít egy API műveleteinek megtekintésére és tesztelésére.

  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.

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

  4. Válassza az Küldés lehetőséget.

    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

Az API-kat különböző szolgáltatások által közzétett API-kból állíthatja össze, többek között a következőket:

  • OpenAPI-specifikáció
  • A SOAP alkalmazásprogramozási felület
  • A GraphQL programozási interfész (API)
  • Az Azure App Service-ben üzemeltetett webalkalmazás
  • Azure Functions (Felhasználói funkciók az Azure-ban)
  • Azure Logic Apps
  • Azure Service Fabric

Feljegyzés

Api importálásakor a műveletek hozzá lesznek fűzve az aktuális API-hoz.

API hozzáfűzése egy meglévő API-hoz:

  1. Nyissa meg az Azure API Management-példányt az Azure Portalon:

    Képernyőkép az API Management-szolgáltatások oldalról.

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

    Képernyőkép, amelyen az API-k kiválasztása látható az Áttekintés lapon.

  3. Jelölje ki a három pontot (...) azon API mellett, amelyhez hozzá szeretne fűzni egy másik API-t.

  4. Válassza Importál a legördülő menüből:

    Képernyőkép az Importálás parancsról.

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

Kapcsolódó tartalom