【问题标题】:How to get the Swagger schema for a specific version of a Swagger API?如何获取特定版本的 Swagger API 的 Swagger 架构?
【发布时间】:2023-03-11 10:35:01
【问题描述】:

我知道我可以将/v3/api-docs/ 添加到我的 API 端点的末尾,以获取我的 API 架构的 JSON 表示。

有没有办法获取特定版本 API 的架构?

【问题讨论】:

  • 此功能特定于您的服务器端框架。您的 API 使用什么服务器/框架/库?
  • 我们正在使用 SpringDoc 库在我们的 Java Springboot 应用程序中生成我们的 OpenAPI/Swagger UI
  • 您正在寻找的是 API 版本控制。关于如何在 Springdoc 中定义 API 组,请参考迁移指南here。

标签: spring-boot swagger openapi springdoc


【解决方案1】:

在我们的例子中,我们有一个版本化的 API。

以下 URI 是我们的整个 JSON 架构,包括所有 API 版本。

.../v3/api-docs

但是,下面的 URI 仅适用于特定的 API 版本。

.../v3/api-docs/v2-tool

v2-tool 对应于特定于我们代码的命名空间。

【讨论】:

    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2020-09-06
    • 1970-01-01
    • 2022-08-14
    • 1970-01-01
    相关资源
    最近更新 更多