如何有两个不同的Swagger模型相同的名称？

vyu0f0g1 于 2022-12-13 发布在其他

关注(0)|答案(2)|浏览(404)

我正在为我的项目编写swagger文档（swagger.json）（它已经完成并处于活动状态）。现在我在对我的对象建模时遇到了一个问题。我有一个名为“Listing”的对象，它用于在内部处理“应用程序”和“服务”。
现在在我的定义中，我希望有两个对象，一个具有与应用程序相关的字段，一个具有与服务相关的字段。但是我希望保持两个对象的名称列表，因为在swagger-ui中，我希望两个对象都显示为列表（因为用户已经使用了API）
有什么帮助吗？

谢谢-谢谢

swagger

来源：https://stackoverflow.com/questions/43041000/how-to-have-two-different-swagger-model-with-same-name

2条答案

按热度按时间

5vf7fwbs1#

方案名必须唯一，例如ApplicationListing与ServiceListing .但您可以设置方案title以自定义Swagger UI中显示得方案名.

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

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

赞(0）回复(0）举报 2022-12-13

pcww981p2#

无需添加唯一的命名类，您可以通过为swagger文档自定义模式名称来实现这一点。
@架构（名称=“应用程序列表”）
和
@架构（名称=“服务列表”）

赞(0）回复(0）举报 2022-12-13