Gyakorlat – API importálása és közzététele

Befejeződött

Most, hogy beállított egy átjárót, készen áll egy API importálására és közzétételére, hogy a partnerek hozzáférhessenek a leltár- és termékadatokhoz.

Itt importálhatja a webes API-t, amely egy OpenAPI-végpontot tesz elérhetővé. Ezután vizualizációval tesztelheti az importált API-t. Végül közzéteszi az API-t.

Megjegyzés:

Ez a gyakorlat az előző gyakorlatban beállított erőforrásokat használja.

Az API importálása

A gyakorlat első része a NorthWind Shoes API importálása egy API Management-átjáróba.

  1. Az Azure Portal erőforrásmenüjében vagy a kezdőlapon válassza a Minden erőforrás lehetőséget, majd válassza ki az API Management szolgáltatást.

  2. Az API Management szolgáltatás menüjében, az API-k alatt válassza az API-kat, majd az + API hozzáadása lehetőséget.

  3. A Létrehozás definícióból csoportban válassza az OpenAPI lehetőséget. Megjelenik a Create from OpenAPI specifikáció panel.

    Add a new API.

  4. Az OpenAPI specifikációs ablakában adja meg a következő beállításokat:

    Beállítás Value
    OpenAPI-specifikáció Illessze be az előző gyakorlatból mentett Swagger JSON URL-címet.
    Megjelenítendő név Fogadja el az alapértelmezett értéket, amelynek a következőnek kell lennie NorthWindShoes Products: .
    Name Fogadja el az alapértelmezett értéket, amelynek a következőnek kell lennie northwindshoes-products: .
    API URL-címének utótagja Hagyja figyelmen kívül ezt a beállítást.
    Kiindulási URL-cím Fogadja el az alapértelmezett beállítást.

    Megjegyzés:

    Megfigyelheti, hogy a JSON URL-címének megadásával számos más mező automatikusan kitölti Önt. Ennek az az oka, hogy az OpenAPI-t használtuk, amely megadja az összes szükséges kapcsolati adatot.

  5. Select Create. Az apim-NorthwindShoesNNNNNN | Az API-k panel a NorthWindShoes Products API összes műveletét megjeleníti.

Az API vizualizációja

A gyakorlat utolsó része az API tesztelése és az eredmények vizualizációja két teszttel. Először adjon ki egy alapszintű GET-kérést, amely egyetlen paramétert ad át.

  1. Az apim-NorthwindShoesNNNNNN | AZ API-k panelen válassza a NorthWindShoes Product API-t, majd a Tesztelés lapot.

  2. Válassza ki az első GET műveletet, keresse meg a megadott termék részleteit. A részletek megjelennek a tesztkonzolon.

  3. A Sablonparaméterek csoportban adja meg a termékazonosító paraméter numerikus értékét.

    Test pane with product ID value highlighted.

  4. Görgessen lefelé, és figyelje meg, hogy a Kérés URL-címe magában foglalja az /api/Products/{productid} utótagot.

  5. Kattintson a Küldés gombra.

    200 OK-választ kell kapnia a GET kérésre, és meg kell adnia a megadott termékazonosító adatait.

    Most teszteljen alapszintű GET kérelemmel, paraméterek nélkül.

  6. Válassza ki a harmadik GET műveletet, kérje le a vállalat teljes termékleltárát, és győződjön meg arról, hogy a Teszt lap ki van jelölve.

    Test pane with third GET request.

  7. Görgessen lefelé, és figyelje meg, hogy a Kérés URL-címe magában foglalja az /api/Inventory utótagot.

  8. Kattintson a Küldés gombra.

    A GET kérésre 200 OK-választ kell kapnia, valamint a hasznos adatban lévő összes termék készletének (készletszintjének) részleteit.