Gyakorlat – API importálása és közzététele
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.
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.
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.
A Létrehozás definícióból csoportban válassza az OpenAPI lehetőséget. Megjelenik a Create from OpenAPI specifikáció panel.
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.
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.
Az apim-NorthwindShoesNNNNNN | AZ API-k panelen válassza a NorthWindShoes Product API-t, majd a Tesztelés lapot.
Válassza ki az első GET műveletet, keresse meg a megadott termék részleteit. A részletek megjelennek a tesztkonzolon.
A Sablonparaméterek csoportban adja meg a termékazonosító paraméter numerikus értékét.
Görgessen lefelé, és figyelje meg, hogy a Kérés URL-címe magában foglalja az
/api/Products/{productid}
utótagot.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.
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.
Görgessen lefelé, és figyelje meg, hogy a Kérés URL-címe magában foglalja az
/api/Inventory
utótagot.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.