Gyakorlat – API hívása előfizetői azonosítóval

  • 5 perc

Az előfizetési kulcsok segítségével korlátozhatja az API-khoz való hozzáférést.

A cipőket forgalmazó NorthWind Shoes vállalat egy beszállítóval dolgozik, és azt szeretné, ha a beszállító közvetlenül hozzá tudna férni a Leltár API-hoz. A partnerhozzáférést egy előfizetési kulccsal kell korlátozni az API-ra irányuló összes híváshoz.

Itt beszerez egy előfizetési kulcsot az API-hoz. Ezután tesztelheti az API-hoz való hozzáférést az előfizetési kulccsal és anélkül.

Előfizetői azonosító beszerzése

A partnerek az előkészítési folyamat részeként kapják meg az azonosítót. Ebben a gyakorlatban egy kifejezetten a NorthWindShoes API-hoz tartozó előfizetést ad hozzá. Ha már rendelkezik egy kulccsal, egy szabványos folyamatot követ a kulcs API-hívásokban való használatához.

  1. Az Azure Portal menüjében vagy a kezdőlapon válassza a Minden erőforrás lehetőséget, majd válassza ki az API Management-példányt.

  2. A bal oldali menüpanel API-k csoportjában válassza az Előfizetések lehetőséget.

  3. Válassza az + Előfizetés lehetőséget, és adja meg az alábbi értékeket az egyes beállításokhoz. Válassza a Létrehozás parancsot.

    Beállítás Value
    Name NorthWind
    Megjelenítendő név NorthWind subscription
    Scope Válassza ki az API-t, majd válassza a NorthWindShoes Products lehetőséget a legördülő listából.

  4. Válassza a Northwind-előfizetés helyi menüjét (...), majd a Kulcsok megjelenítése/elrejtése lehetőséget.

  5. Kattintson a Kattintás gombra az ELSŐDLEGES KULCS másolásához.

  6. Mentse el valahová ezt a kulcsot, például a Jegyzettömbbe.

Előfizetői azonosító használata API-hívásban

A következő lépés a közzétett API fejlesztői hozzáférésének tesztelése az előfizetői azonosítóval.

  1. Futtassa az alábbi parancsot a Cloud Shellben az API Termékek műveletének eléréséhez az átjáró nevére cserélve <apim gateway> .

    curl https://<apim gateway>.azure-api.net/api/Products

    Egy 401-et kap , a hozzáférés megtagadva, mert hiányzik az előfizetés kulcsüzenete .

  2. Most ismételje meg a curl-kérést, ezúttal az előfizetési kulccsal együtt.

  3. Futtassa a következő parancsot a Cloud Shellben, cserélje le <primary key> a korábban mentett kulccsal, és cserélje le <apim gateway> az átjáró nevére.

    curl --header "Ocp-Apim-Subscription-Key: <primary key>" https://<apim gateway>.azure-api.net/api/Products

    Elvileg így eléri az API-t, és a termékek listája megjelenik a konzolon.