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

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跨境电商联系。