Azure API Management （1）APIM入門,azurewave technology inc

Azure API Management （1）APIM入門

于書振，原國家電網公司特高壓電力專家,原中國聯通5G創新中心高級解決方案經理，國內較早實施5G智慧港口和邊緣計算的新基建踐行者。十余年特高壓/智慧城市/5G/云計算/物聯網等領域的工作經驗，Microsoft Certified Azure Solutions Architect Expert，Microsoft Certified Azure IoT Developer Specialty，Microsoft Certified Trainer，2020年被評為微軟MVP。他熱心社區奉獻，運營公眾號“云計算實戰”分享接地氣的Azure IoT和AI實戰內容，同時為每一個實戰內容制作了15分鐘左右的視頻講解發布在B站和其博客https://www.51azure.cloud。

01

創建APIM實例

創建需要幾分鐘時間，創建完成轉到資源可看到如下界面：

02

向API Management添加一組后端API

向apim添加api后，將使用apim的url代替原有后端api的url進行訪問。本文使用了微軟官方提供的測試api：https://conferenceapi.azurewebsites.net/ format=json

我們可以先看下這個由微軟提的測試api：

將url中的?format=json去掉，可以看到如下頁面，改頁面描述了這一組api中的每個api的請求類型（get/post），參數，返回值等等。

我們測試其中某個get請求，以get speakers為例，在url中直接輸入如下地址，即可得到speakers的列表：https://conferenceapi.azurewebsites.net/speakers

點擊api標簽，點擊添加openapi：

輸入如下地址：https://conferenceapi.azurewebsites.net/?format=json

可以為api增加一個后綴，例如本例中使用了“seanfirstapi”作為后綴：

添加成功后，可以看到如下界面：

03

體驗使用Azure Portal通過APIM測試調用后端API

可以在Azure Portal對單個API進行測試，例如我們對get speakers進行測試，點擊要測試的API，點擊“Test”，點擊“Send”即可得到從后端API返回的結果：

注意，在此過程中，可以修改header，查詢參數等；

得到結果如下：

04

體驗使用Postman調用被APIM保護(即為API開啟訂閱功能)的后端API

在請求header中我們注意到如下內容：

Ocpapimsubscriptionkey：xxxxxxxxxxxx

這個key是APIM對API增加的一種“保護”，防止未經授權的客戶端隨意對API進行訪問。

我們也可以在瀏覽器中嘗試get speakers api，原始后端api可以直接返回結果，使用apim后，則返回：

{statusCode:401,message:Access denied due to missing subscription key.Make sure to include subscription key when making requests to an API.}

在訂閱頁面，我們能找到能夠順利調用該api的訂閱，將其中的“builtin all access subscription”中的key添加到request header的Ocpapimsubscriptionkey里即可訪問apim保護的api，

如下圖，在postman中設置header，然后可以正確返回結果。

05

去掉APIM對API的訂閱保護

如果你的api是要公開給公眾使用或其他原因就無需訂閱保護，則可以在api上setting里，將需要訂閱的選框去掉，保存后，即可無需Ocpapimsubscriptionkey就能正常訪問了。

微軟最有價值專家是微軟公司授予第三方技術專業人士的一個全球獎項。27年來，世界各地的技術社區領導者，因其在線上和線下的技術社區中分享專業知識和經驗而獲得此獎項。

MVP是經過嚴格挑選的專家團隊，他們代表著技術最精湛且最具智慧的人，是對社區投入極大的熱情并樂于助人的專家。MVP致力于通過演講、論壇問答、創建網站、撰寫博客、分享視頻、開源項目、組織會議等方式來幫助他人，并最大程度地幫助微軟技術社區用戶使用Microsoft技術。

更多詳情請登錄官方網站：

https://mvp.microsoft.com/zhcn

特別聲明：以上文章內容僅代表作者本人觀點，不代表ESG跨境電商觀點或立場。如有關于作品內容、版權或其它問題請于作品發表后的30日內與ESG跨境電商聯系。