安排多个 REST API Swagger 规范

Arrange multiple REST API Swagger specifications

我们针对不同的项目使用基于 Swagger 的 REST API 规范。所以每个项目都有自己的 Swagger UI 和端点描述。所有这些 UI 都部署在不同的服务器上,在不同的域名下,从组织的角度来看,这一点都不酷。

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

我发现了一些不错的 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 testing/validations 工具。 SwaggerHub 的最大优势是定价。每个 $ 的规格数量的比率是最好的,每个 API 上最多有 25 个协作者:swaggerhub.com/prices