【问题标题】: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

    【讨论】:

      猜你喜欢
      • 2021-07-21
      • 1970-01-01
      • 2022-08-16
      • 2018-08-03
      • 2021-02-09
      • 1970-01-01
      • 2020-11-14
      • 2016-07-31
      • 2017-07-08
      相关资源
      最近更新 更多