BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

HTTP API领域在围绕OAS进行整合

| 作者 Abel Avram 关注 11 他的粉丝 ,译者 张卫滨 关注  他的粉丝 发布于 2017年6月1日. 估计阅读时间: 4 分钟 | ArchSummit北京2018 共同探讨机器学习、信息安全、微服务治理的关键点

MuleSoft业已成为OAI的成员,并发布了能够同时理解RAML和 OAS的API模型框架。Restlet Studio如今已经支持RAML。

目前,有三个主要的HTTP API规范在竞争:Open API Initiative(OAI)基于Swagger所提供的Open API Specification(OAS)、MuleSoft作为主要贡献者的RAML以及Apiary所支持的API Blueprint,Apiary公司今年已经被Oracle收购。这三个规范都有自己的优点和相关工具,但是在2015年Swagger托管给Linux基金会之后,OAS获得了社区的主流支持。OAS从一开始就得到了3Scale、Apigee、Google、IBM、Microsoft、PayPal以及其他厂商的支持。

HTTP API领域在未来将会如何演化尚不明晰,但是最近发生了一些很有意思的事情。其中有一件事就是MuleSoft最近宣布加入OAI。MuleSoft的CTO同时也是RAML的创建者Uri Sarid已经开始参与OAI技术开发者社区并认为“每个人都应该支持一种通用的格式,它至少要能够描述API的服务模型”,这种格式应该是“目前采用最广泛的,即OpenAPI规范。”

鉴于MuleSoft依然“致力于支持RAML倡议及其投资,并且在扩大该生态系统”,我们可以得出结论,Sarid在OAI TC的主要目的是推动OAS的开发采纳RAML目前已经支持的一些特性:API建模、支持模块以及分离API协议的关注点。至于OAI TC会从RAML上借鉴多少内容尚有待观察。为此,MuleSoft已经开源了API建模框架,这是一种与API交互的方式,还包含对API的建模,以及随后生成RAML或OAS文档。实际上,我们可以将RAML定义的API,对其进行解析并生成相应的OAS文件。

MuleSoft的API建模框架依然是“alpha”和“实验性”阶段,Restlet是OAI的初始成员之一,最近又加入了RAML工作组,发布了新版本的Studio,能够同时支持OAS和RAML。Restlet的创始人Jerome Louvel阐述了RAML对OAS的影响:

与其让这三种方案进行直接的竞争,我们还是希望其中有一个能够获胜,取代另外的两个,有必要也有可能采用一种更好的演化路径。这个过程中的主要参与者和构建工具,比如Restlet Studio,同时支持OAS和RAML,并且会倾听用户的需求,我意识到理想状况是让Apiary和MuleSoft加入Open API Initiative,并逐渐做出贡献,使其变得收敛,而不一定要将这三个规范合并在一起...

在即将发布的OAS 3.0之上,我设想未来的RAML释放版本会扩展OAS规范,以捕获目前通过RAML 1.0表述的API建模信息。它将会让OAS核心更加简单和专注,同时还能够让API建模工具之间实现更好的交互,有助于保护API团队在设计之时所做的投资。Restlet是OAI的创始成员,最近又加入了RAML工作组,我希望能够直接为这些目标作出贡献。

确实,Apiary去年加入了OAI,并且为他们的工具添加了对Swagger的支持。HTTP API领域似乎正在围绕OAS进行整合。这意味着将来会有一个API规范,用户创建互操作的API会更加容易。至于RAML和API Blueprint会对OAS带来多大的影响,尚有待观察。

查看英文原文:The HTTP API Space is Consolidating around OAS

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT