Azure API Management （1）APIM入門,azurewave technology inc-ESG跨境

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

Azure API Management （1）APIM入門

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

01

創(chuàng)建APIM實(shí)例

創(chuàng)建需要幾分鐘時(shí)間，創(chuàng)建完成轉(zhuǎn)到資源可看到如下界面：

02

向API Management添加一組后端API

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

我們可以先看下這個(gè)由微軟提的測(cè)試api：

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

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

點(diǎn)擊api標(biāo)簽，點(diǎn)擊添加openapi：

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

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

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

03

體驗(yàn)使用Azure Portal通過(guò)APIM測(cè)試調(diào)用后端API

可以在Azure Portal對(duì)單個(gè)API進(jìn)行測(cè)試，例如我們對(duì)get speakers進(jìn)行測(cè)試，點(diǎn)擊要測(cè)試的API，點(diǎn)擊“Test”，點(diǎn)擊“Send”即可得到從后端API返回的結(jié)果：

注意，在此過(guò)程中，可以修改header，查詢參數(shù)等；

得到結(jié)果如下：

04

體驗(yàn)使用Postman調(diào)用被APIM保護(hù)(即為API開(kāi)啟訂閱功能)的后端API

在請(qǐng)求header中我們注意到如下內(nèi)容：

Ocpapimsubscriptionkey：xxxxxxxxxxxx

這個(gè)key是APIM對(duì)API增加的一種“保護(hù)”，防止未經(jīng)授權(quán)的客戶端隨意對(duì)API進(jìn)行訪問(wèn)。

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

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

在訂閱頁(yè)面，我們能找到能夠順利調(diào)用該api的訂閱，將其中的“builtin all access subscription”中的key添加到request header的Ocpapimsubscriptionkey里即可訪問(wèn)apim保護(hù)的api，

如下圖，在postman中設(shè)置header，然后可以正確返回結(jié)果。

05

去掉APIM對(duì)API的訂閱保護(hù)

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

微軟最有價(jià)值專家是微軟公司授予第三方技術(shù)專業(yè)人士的一個(gè)全球獎(jiǎng)項(xiàng)。27年來(lái)，世界各地的技術(shù)社區(qū)領(lǐng)導(dǎo)者，因其在線上和線下的技術(shù)社區(qū)中分享專業(yè)知識(shí)和經(jīng)驗(yàn)而獲得此獎(jiǎng)項(xiàng)。

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

更多詳情請(qǐng)登錄官方網(wǎng)站：

https://mvp.microsoft.com/zhcn

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