如何拥有两个具有相同名称的不同 Swagger 模型？答案

【问题标题】：How to have two different Swagger Model with same name?如何拥有两个具有相同名称的不同 Swagger 模型？
【发布时间】：2017-03-27 08:07:17
【问题描述】：

我正在为我的项目（已经完成并且还活着）编写 swagger 文档（swagger.json）。现在我在为我的对象建模时遇到了问题。我有一个名为“Listing”的对象，用于在内部处理“应用程序”和“服务”。

现在在我的定义中，我想要两个对象，一个带有应用程序相关字段，一个带有服务相关字段。但我想保留两个对象的名称列表，因为在 swagger-ui 中我希望这两个对象都显示为列表（因为用户已经使用了 API）

有什么帮助吗？

谢谢。

【问题讨论】：

标签： rest documentation swagger jersey-2.0 swagger-2.0

【解决方案1】：

架构名称必须是唯一的，例如 ApplicationListing 和 ServiceListing。但是您可以设置架构title 来自定义在 Swagger UI 中显示的架构名称。

definitions:
  ApplicationListing:
    title: Listing
    description: Application listing
    type: object
    ...

  ServiceListing:
    title: Listing
    description: Service listing
    type: object
    ...

【讨论】：