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的用户友好界面更加直观。