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:import
xsd:import
xsd: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
EGY API Management-példány. Ha még nincs ilyenje, végezze el az alábbi rövid útmutatót: Azure API Management-példány létrehozása.
Azure CLI
Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
Azure PowerShell
- Ha az Azure PowerShell helyi használatát választja:
- Telepítse az Az PowerShell-modul legújabb verzióját.
- Csatlakozás az Azure-fiókjába az Csatlakozás-AzAccount parancsmag használatával.
- Ha az Azure Cloud Shell használata mellett dönt:
- További információkért tekintse meg az Azure Cloud Shell áttekintését.
- Ha az Azure PowerShell helyi használatát választja:
Háttér API importálása
Az Azure Portalon keresse meg az API Management-példányt.
A bal oldali menüben 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ó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.
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.
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.
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 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.
Válassza ki az előző lépésben létrehozott API-t.
Kattintson a Teszt fülre.
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.
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:
- A portálon válassza ki az előző lépésben létrehozott API-t.
- A Tervezés lapon válassza a + Művelet hozzáadása lehetőséget.
- Adja meg a művelet megjelenítendő nevét .
- 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.
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.
Kapcsolódó témakörök
- API-importálási korlátozások
- OpenAPI-specifikáció importálása
- SOAP API importálása
- SOAP API importálása és konvertálása REST-té
- App Service API importálása
- Container App API importálása
- WebSocket API importálása
- GraphQL API-k importálása
- GraphQL-sémák importálása és mezőfeloldók beállítása
- Azure-függvényalkalmazás importálása
- Azure Logic App-alkalmazás importálása
- Service Fabric-szolgáltatás importálása
- Azure OpenAI API importálása
- OData API importálása
- SAP OData-metaadatok importálása
- GRPC API importálása
- API szerkesztése