Azure API Management （2）體驗開發(fā)者門戶,微軟azure云虛擬服務器-ESG跨境

Azure API Management （2）體驗開發(fā)者門戶,微軟azure云虛擬服務器

Azure API Management （2）體驗開發(fā)者門戶

于書振

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

幾個重要的概念

1.API

導入或者在Azure Portal上創(chuàng)建的一組API或者多組API，例如導入了一組訂單相關API和一組庫存相關API；

2.產品

產品包含至少一組API，通常產品把多組API打包在一起，形成一個包含多種功能的一個集合，例如：定義了一個產品“進銷存”，該產品包含一組訂單相關的API和一組庫存相關的API；

3.用戶

這里的用戶通常指使用API Management的人員，其中包含要調用你發(fā)布的API的開發(fā)人員。

4.組

組指的用戶組，一個組可以包含多個成員，也就是包含多個“用戶”，系統(tǒng)內置了“Administrator”，“Developer”，“Guests”三個組。

5.訂閱

訂閱決定了哪個”用戶“可以調用哪個“API”或者哪個“產品”。

訂閱是綁定到“用戶”上的，訂閱能控制某個API或某個產品。

6.開發(fā)人員門戶（developer portal）

通常情況下，開發(fā)人員門戶是提供給“用戶”，也就是要調用你API的人員使用的一個門戶網站。

用戶可以在這個網站維護自己的賬號信息，查看自己的訂閱信息，查看API文檔/在線測試API。

默認情況下，他的url后半部分為：developer.azureapi.net;

可以在開發(fā)人員門戶上提交注冊信息，根據配置，可能需要審核或自動完成審核，然后便成了“用戶”，用戶可以根據API及產品是否需要訂閱或者訂閱權限調用對應的API。

在開發(fā)人員門戶上自主注冊的用戶，默認自動分配到“Developer”組中。

通常整體的使用流程是：

管理員（也就是API的提供者）從Azure Portal導入后端API

管理員在Azure Portal對導入的API進行設置，比如增加流控等功能

管理員在Azure Portal創(chuàng)建一個包含一組或多組API的產品并發(fā)布

管理員在Azure Portal發(fā)布開發(fā)人員門戶（通常該步驟僅執(zhí)行一次）

用戶從開發(fā)人員門戶自主注冊或者從管理員從Azure Portal上注冊用戶

管理員從Azure門戶上為用戶創(chuàng)建訂閱

用戶在開發(fā)人員門戶學習如何調用API并做測試

用戶在自己的業(yè)務系統(tǒng)中調用API

01

管理員（也就是API的提供者）從Azure Portal導入后端API

上一講分享的內容中，我們已經完成了API的導入，本文不再贅述，如果您尚未完成API導入，請參照《Azure API Management（1）Create APIM And Add First API,創(chuàng)建Azure APIM并添加后端API》

02

管理員在Azure Portal對導入的API進行設置，比如增加流控等功能

流控等功能我們在以后的章節(jié)中介紹，本文可以跳過這個步驟。

03

管理員在Azure Portal創(chuàng)建一個包含一組或多組API的產品并發(fā)布

注意：

3處的狀態(tài)為“未發(fā)布”，未發(fā)布的產品不會在開發(fā)者門戶中看到。稍后需要執(zhí)行”發(fā)布產品“操作后，才會出現在開發(fā)者門戶中；

3處的“需要訂閱”如果不勾選，則用戶在開發(fā)者門戶中無需訂閱即可進行該產品關聯api的調用；

5處的API可以選擇多個或者一個；

產品創(chuàng)建完成后，默認的訪問控制組在“Administrator”中，如果需要被“開發(fā)者么戶”中創(chuàng)建的用戶訪問，則需要添加“developers”組，因為從門戶自主注冊的用戶，默認為“developers”組：

發(fā)布產品，只有發(fā)布后的產品，才會顯示在開發(fā)人員門戶中：

04

管理員在Azure Portal發(fā)布開發(fā)人員門戶（通常該步驟僅執(zhí)行一次）

注意：如果不開啟cors，則用戶在開發(fā)人員門戶上無法測試api調用。

05

用戶從開發(fā)人員門戶自主注冊或者從管理員從Azure Portal上注冊用戶

點擊開發(fā)人員門戶可以進入開發(fā)人員門戶，此時是管理員默認登錄對門戶的編輯模式，需要切換瀏覽器，才能以新的用戶session訪問開發(fā)人員門戶：

點擊右上角注冊：

默認注冊使用郵箱和密碼方式：

在郵箱中查收驗證郵件并驗證郵箱：

登錄開發(fā)人員門戶：

登錄成功，看到如下頁面：

查看profile：

注意，此時新用戶并沒有任何subscription，稍后我們將在Azure Portal為用戶添加訂閱。

06

管理員從Azure門戶上為用戶創(chuàng)建訂閱

在Azure Poral中查看剛注冊成功的用戶：

用戶即開發(fā)人員，也就是要使用你api的人員；

從developer portal自主創(chuàng)建的用戶，默認在“developer”組中。

為用戶創(chuàng)建分配訂閱：

在用戶頁面點擊訂閱，添加訂閱：

新建訂閱可以產品級別或者API級別的訂閱，本例選擇產品級別的訂閱，并選擇剛才發(fā)布的產品。

在下拉列表中選擇剛才發(fā)布的產品，然后創(chuàng)建訂閱。

用戶可以在開發(fā)人員門戶中查看管理員為你分配的訂閱：

在developer portal中查看分配的訂閱：

07

用戶在開發(fā)人員門戶學習如何調用API并做測試

在開發(fā)人員portal中進行api測試：

subscription key在創(chuàng)建時是有作用范圍的，本例中，我們將subscription key的權限綁定到“newproduct”上，因此，該key在其他product或者其為包含在“newproduct”里的api，都是無效的：

如下圖，我們用subscription key對echo api進行訪問，結果為401：

08

用戶在自己的業(yè)務系統(tǒng)中調用API

針對多語言的示例代碼，將代碼集成到自己的業(yè)務系統(tǒng)中，完成API調用開發(fā)。

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

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

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

https://mvp.microsoft.com/zhcn

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