我可以使用一些帮助来决定使用哪种API描述语言用于我们的团队在IBM Cloud以及将来可能部署Azure的API。
我们一直在非正式地使用API Blueprint,但是当在Bluemix上注册API时,我注意到它(和Azure)已经集成了OpenAPI。但是,我不知道API Blueprint是否也是如此。我一直试图找到一些可以帮助决定走哪条路的东西,但除了Blueprint和Swagger网站本身之外,我找不到太多东西。
我想知道两者在Bluemix和Azure环境中是否可以互换,或者如果它们之间存在差异,那么我可以列出优缺点。鉴于我们已经在API蓝图方面取得了进展。
答案 0 :(得分:1)
ALO,
注意:对于Azure来说,我是初学者。
开放API规范(OAS)已得到IBM和Microsoft的支持,已有几年或更长时间了。因此,当您使用IBM Cloud和Azure时,OAS是一个安全的选择。 APIc产品(内部部署或其云产品)支持OAS,并且从早期开始就支持swagger(已经演变为OAS)。
APIc不支持API Blueprint(您无法将API Blueprint文件导入APIc)。
从Azure文档中,我看不到对APIBlueprint的任何引用,以推动我无法导入API Blueprint定义的资源。
我可以在导入API定义的上下文中看到对swagger / OAS here的引用,但不会引用API Blueprint。