【问题标题】:Arrange multiple REST API Swagger specifications安排多个 REST API Swagger 规范
【发布时间】:2016-12-17 22:23:39
【问题描述】:
我们为不同的项目使用基于 Swagger 的 REST API 规范。所以每个项目都有自己的 Swagger UI 和端点描述。所有这些 UI 都部署在不同的服务器上,使用不同的域名,从组织的角度来看,这一点都不酷。
有没有什么不错的选择可以在一个地方存储多个 Swagger 规范?它可以是使用 Swagger 规范的 REST API 描述管理的任何服务。
【问题讨论】:
标签:
rest
swagger
specifications
swagger-ui
【解决方案1】:
我发现一些不错的 REST API 规范管理选项:
-
养蜂场 (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 上最多有 25 个协作者,每美元的规格数量比率是最好的:swaggerhub.com/prices