我正在为我的项目编写swagger文档(swagger.json)(已完成并且活着)。现在我对我的对象建模有问题。 我有一个名为" Listing"的对象,用于处理"应用程序"和"服务"内部。
现在在我的定义中,我希望有两个对象,一个与应用程序相关的字段,另一个与服务相关的字段。但是我希望将名称列表保留给两个对象,因为在swagger-ui中我希望两个对象都显示为列表(因为API已经被用户使用)
任何帮助?
感谢。
答案 0 :(得分:2)
架构名称必须是唯一的,例如ApplicationListing
和ServiceListing
。但您可以设置架构title
以自定义Swagger UI中显示的架构名称。
definitions:
ApplicationListing:
title: Listing
description: Application listing
type: object
...
ServiceListing:
title: Listing
description: Service listing
type: object
...