微软宣布在Azure API管理中预览OpenAPI规范V3

最近，微软宣布在Azure API管理中支持OpenAPI规范V3，他们的服务允许创建、发布、监控和维护API。OpenAPI规范的使用是通过 OpenAPI .NET SDK完成的，并支持从它们的实现中抽象出API定义。

OpenAPI规范（以前称为Swagger）提供了以独立于语言的方式描述RESTful Web服务的方法。随着OpenAPI的广泛采用，已经形成了一个多样化的生态系统，我们可以使用各种工具来设计、记录、构建、测试和实现治理。该规范受Linux基金会下属的OpenAPI Initiative监督，并有各种各样的组织推动其开发，包括SmartBear、微软和WSO2等公司。任何人都可以在OpenAPI Initiative的GitHub存储库上跟踪甚至参与规范的开发。

根据微软Azure MVP和Azure架构师Tom Kerkhove的说法，在向消费者公开API时，规范扮演着重要的角色。

API必须干净整洁且文档良好。这让你的消费者可以知道你提供了哪些功能、它们的用途以及可以有怎样的期望。这就是OpenAPI规范（又名Swagger）的作用所在，它定义了应该如何在整个行业中定义API，而不管其背后的技术是什么。

规范的版本3带来了一些变化，现在Azure API管理也已经支持这些变化。例如，这个新版本引入了一个包含诸如消息头、链接和回调等组件的全新体系结构，在定义中采用了更加模块化的方法，RestCase首席执行官Guy Levin对此进行了描述。

3.0版本的API规范格式采用一种更加模块化且可重用的方法定义API表面（surface area），提供了更强大的请求和响应模型描述能力和灵活性，并详细描述了构成API用法的通用组件，如底层数据模式和安全定义。

引入的另一个选项是在操作中包含callbacks，这意味着现在可以定义webhook。最后，链接（linking）使我们可以定义API的不同路径之间的关系，提供了属性扩展能力。

随着公告发布，现在已经可以在Azure API管理中导入OpenAPI V3定义，尽管有一些限制。目前，既可以通过门户，也可以通过REST API。接着，导出OpenAPI描述的功能也已经可用，可以通过开发者门户，或使用另一个REST API调用。

最终，这些功能将正式发布，使用PowerShell SDK进行定义的导入和导出也会成为可能。

查看英文原文：

https://www.infoq.com/news/2019/01/openapi-v3-support-azure-apim

微软宣布在Azure API管理中预览OpenAPI规范V3相关推荐

如何使用Azure API管理服务？
对打通云应用之间的通信而言,API至关重要,正确管理这些API也非常关键.让我们从学习Azure的API服务来开始这一进程. 在云和微服务架构时代,API是数字化业务的通用语言.根据分析公司Forre ...
微软发布用于Kafka生态系统的Azure Event Hub公开预览版
\ 看新闻很累?看技术新闻更累?试试下载InfoQ手机客户端,每天上下班路上听新闻,有趣还有料! \ \\ 在Build 2018大会期间,微软宣布它将支持Kafka客户端与Azure Event H ...
azure api 管理_具有Azure功能的无服务器API
azure api 管理在这篇文章中,我将研究一个非常简单的用例. 在执行部署管道时, FlexDeploy可能会产生一些应被批准或拒绝的人工任务. 例如,某人必须批准对生产环境的部署. 可以在Fl ...
azure api 管理_通过成本管理跟踪Azure成本
azure api 管理 The Azure Portal offers the free tool Cost Management that we can use for managing Azur ...
azure api 管理_Azure Cosmos DB和MongoDB API入门
azure api 管理 In the previous article on Azure Cosmos DB, we reviewed NoSQL concepts and how to integ ...
azure api 管理_使用API使用Azure Cosmos DB进行图形数据库实现
azure api 管理 In my previous article, I've discussed a lot about the Graph database implementation wi ...
帅呆了！微软即将发布 Visual Studio for Mac 预览版
编者注:Visual Studio for Mac - Introducing Visual Studio for Mac 这篇英文原文链接现在已无法访问,猜测这篇文章应该是在 Connect (); ...
Android Studio 3.4增可视化资源管理工具可管理和预览项目资源
经过6个月的开发时间,网络大厂17日发布了最新版的App开发IDE Android Studio 3.4,现在就能够下载使用,除了有超过300个错误修护和稳定度增强之外,在开发.建置和测试App阶段, ...
Qt Creator在浏览器中预览
Qt Creator在浏览器中预览在浏览器中预览在浏览器中预览 Qt Design Viewer是在您的Web浏览器中运行的QML查看器.这意味着您可以在台式机和移动设备上的最广泛使用的Web浏览 ...

微软宣布在Azure API管理中预览OpenAPI规范V3

微软宣布在Azure API管理中预览OpenAPI规范V3相关推荐

最新文章

热门文章