Swagger与Apiary有什么区别？

　　Swagger和Apiary是手机软件开发者用以搭建，应用，设计方案和纪录RESTful根据Web的服务项目的二种时兴的专用工具。殊不知，Swagger是开源系统的而Apiary并不是。虽然在彼此之间开展挑选很有可能很艰难，但有一些细微的差别毫无用处，这就是我们将在文中中讨论的內容。在考虑到Apiary Vs.Swagger，做为开发者或开发软件企业，也有很多非常值得考虑到的事儿

　　Swagger是什么?

　　Tony Tam最开始在2011年建立了一个swagger API新项目。他开发设计了一个名叫Wordnick商品的商品，在开发设计全过程中，他发觉API文本文档和SDK转化成让人消沉。这造成Tam设计方案了一个比较简单的API的JSON表明，关键根据REST的协调能力和应用SOAP协议书的很多专用工具和作用。

　　今日，Swagger是一个开源项目架构，它正好获得了巨大的专用工具生态体系的适用，这种专用工具能够协助全部种类的开发者搭建，纪录设计方案RESTful服务项目。虽然Swagger在其UI中是最非常容易鉴别的，但全自动代码生成，功能测试转化成和全自动文本文档的工具箱使其出类拔萃。 它关键由SmartBear Software适用和冠名赞助，是一个获得开源项目全力支持的新项目。

　　Apiary是啥?

　　Apiary更适当地称之为Apiray.io是一套代管专用工具，可协助公司迅速搭建其Web API。它容许她们轻轻松松监管，检测和纪录每一个商品。API使用者能够浏览必需的基本构造，这有利于她们与客户创建关联。

　　该解决方法的关键是API Blueprint，它是一种关键叙述API的高效率文件格式，而且期盼变成全部REST API开发设计的高品质金子规范。宏伟蓝图用以根据简易集成化到别的系统软件来简单化全部新服务项目的选用。殊不知，Apiary发觉以往很难说服Swagger客户迁移到服务平台。

　　Apiary出示比较有限的Swagger作用

　　直至近期，Apiary才应用一种语言表达，即API Blueprint。可是，该服务项目近期也可以应用Swagger。现阶段，对Apiary中Swagger的适用正处在产品测试。除此之外，该企业已经再次进一步开发设计API Blueprint。Apiary发布了很多说白了的更改游戏的规则的作用，如MSON。 Swagger不兼容全部Apiary作用。该企业认可，有很多工作中要做，也有较长的路要走。可是，检测和认证适用早已发布。未来，方案让开发者在二种语言表达中间挪动。因而，客户能够挑选她们要想的描述语言，并将Apiary作为大量的设计平台。

　　Swagger的发展方向

　　Swagger已经将其标准迁移到OpenAPI，它是一项开源系统领域的勤奋，致力于寻找全部API专用工具中间互用的方式。Apiary并未添加OpenAPI方案，但权威专家很有可能迅速便会产生这类状况。顺带提一下，OpenAPI关键根据Swagger 2.0标准，Apiary适用Swagger 2.0。

　　结果

　　Swagger和Apiary中间的挑选都归纳为您已经开展的项目类型。在没多久的未来，它很有可能归纳为您觉得最合适您的新项目或您觉得它更合理的內容。殊不知，这些要想在二种语言表达中间转换的人会发觉Apiary是一个更强的挑选，虽然Swagger的客户友善页面更为形象化。