OpenAPI-specifikáció importálása

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

Ez a cikk bemutatja, hogyan importálhat egy "OpenAPI specifikáció" háttéralkalmazási API-t az Azure API Managementbe különböző eszközökkel. A cikk azt is bemutatja, hogyan tesztelheti az API-t az API Managementben.

Ebben a cikkben az alábbiakkal ismerkedhet meg:

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.
    • Csatlakozzon az Azure-fiókjához a Connect-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.

Háttér API importálása

Ebben a példában importálja a nyílt forráskód Petstore API OpenAPI-specifikációját, de helyettesítheti a választott OpenAPI-specifikációt.

# API Management service-specific details
APIMServiceName="apim-hello-world"
ResourceGroupName="myResourceGroup"

# API-specific details
APIId="swagger-petstore"
APIPath="store"
SpecificationFormat="OpenAPI"
SpecificationURL="https://petstore3.swagger.io/api/v3/openapi.json"

# Import API
az apim api import --path $APIPath --resource-group $ResourceGroupName \
    --service-name $APIMServiceName --api-id $APIId \
    --specification-format $SpecificationFormat --specification-url $SpecificationURL

# API Management service-specific details
$apimServiceName = "apim-hello-world"
$resourceGroupName = "myResourceGroup"

# API-specific details
$apiId = "swagger-petstore"
$apiPath = "store"
$specificationFormat = "OpenAPI"
$specificationUrl = "https://petstore3.swagger.io/api/v3/openapi.json"

# Get context of the API Management instance. 
$context = New-AzApiManagementContext -ResourceGroupName $resourceGroupName -ServiceName $apimServiceName

# Import API
Import-AzApiManagementApi -Context $context -ApiId $apiId -SpecificationFormat $specificationFormat -SpecificationUrl $specificationUrl -Path $apiPath

OpenAPI-specifikáció megtekintése és szerkesztése

A portálon az OpenAPI specifikációszerkesztőjével megtekintheti, érvényesítheti vagy szerkesztheti az importált API specifikációját.

Az OpenAPI specifikációszerkesztőjének használata:

1. Az Azure Portalon keresse meg az API Management-példányt.
2. A bal oldali menüBEN, az API-k alatt válassza az API-k><az ÖSSZES API-műveletet.>>
3. A Tervezés lap Frontend területén válassza az OpenAPI Specifikációszerkesztőt (ceruza ikon). A specifikáció JSON vagy YAML formátumban is megnyitható.
4. Szükség szerint tekintse át vagy szerkessze a specifikációt. Mentse a módosításokat.

Ellenőrzés OpenAPI-specifikációs sémával

Az API Management érvényesítési szabályzatait úgy konfigurálhatja, hogy a kéréseket és válaszokat (vagy azok elemeit) az OpenAPI-specifikáció sémájára érvényesítse. Használhatja például a tartalomérvényesítési szabályzatot egy kérés vagy válasz törzs méretének vagy tartalmának ellenőrzéséhez.

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.

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.

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

   

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

   

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.

   

5. 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

Következő lépések