如何使用两个不同的Swagger模型同名?

时间:2017-03-27 08:07:17

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

我正在为我的项目编写swagger文档(swagger.json)(已完成并且活着)。现在我对我的对象建模有问题。 我有一个名为" Listing"的对象,用于处理"应用程序"和"服务"内部。

现在在我的定义中,我希望有两个对象,一个与应用程序相关的字段,另一个与服务相关的字段。但是我希望将名称列表保留给两个对象,因为在swagger-ui中我希望两个对象都显示为列表(因为API已经被用户使用)

任何帮助?

感谢。

1 个答案:

答案 0 :(得分:2)

架构名称必须是唯一的,例如ApplicationListingServiceListing。但您可以设置架构title以自定义Swagger UI中显示的架构名称。

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

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