2016-08-11 27 views
1

我们对不同的项目使用基于Swagger的REST API规范。所以每个项目都有自己的Swagger用户界面和终端描述。所有这些用户界面都部署在不同的服务器上,位于不同的域名下,从组织的角度来看,这根本就不酷。排列多个REST API Swagger规格

有什么好的选择,存储多个扬鞭规格在一个地方?它可以是REST API描述管理的任何服务,它使用Swagger规范。

回答

3

我发现一个REST API规范管理的一些不错的选择:

  • 蜂房(apiary.io)
  • 的Restlet(restlet.com)
  • SwaggerHub(swaggerhub。 COM)

所有三个服务支持OpenAPI Specification,它基于Swagger 2.0规范。

蜂房具有良好的协同管理,并支持REST API验证。 但是,它非常昂贵。一个合适的计划成本每月99美元:apiary.io/pricing

restlet也有一个协作工作的可能性,它支持功能测试。 相较于蜂房,拥有的Restlet一个更好的选择的定价选项:restlet.com/pricing

SwaggerHub是在我的情况下,最优化的选择。它专为多个Swagger规格管理而设计。该服务支持为Swagger开发的所有代码生成器。不过,它不提供与Apiary和Restlet不同的REST API测试/验证工具。 SwaggerHub的最大优势是定价。每个API的规格数量与最多25位合作者的比例最高:swaggerhub.com/prices