排列多个REST API Swagger规范

时间:2016-08-11 09:07:47

标签: rest swagger specifications swagger-ui

我们对不同的项目使用基于Swagger的REST API规范。因此,每个项目都有自己的Swagger UI,其中包含端点的描述。所有这些UI都部署在不同的域名下的不同服务器上,从组织的角度来看,这根本不是很酷。

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

1 个答案:

答案 0 :(得分:3)

我找到了一些很好的REST API规范管理选项:

  • Apiary (apiary.io)
  • Restlet (restlet.com)
  • SwaggerHub (swaggerhub.com)

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

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

Restlet 还可以进行协作工作,并支持功能测试。 与Apiary相比,Restlet有更好的价格选择:restlet.com/pricing

在我的情况下,

SwaggerHub 是最佳选择。它专为多个Swagger规范管理而设计。该服务支持为Swagger开发的所有代码生成器。然而,与Apiary和Restlet不同,它不提供REST API测试/验证工具。 SwaggerHub的最大优势在于定价。每个API的规格数量比率最佳,每个API最多可包含25个协作者:swaggerhub.com/prices