swagger - 如何从 swagger 定义中排除属性

Question

我正在使用 Swagger 在线编辑器。我在定义中创建了一些模型

  Object:
    type: object
    properties:
      id:
        type: integer
        format: int32
      name:
        type: string
      some_variable_to_exclude:
        type: string

这是完整的模型，我在不同的响应中使用它。但是在其中之一中，我希望我的模型不存在属性“some_variable_to_exclude”。我怎样才能排除它？是否可以 ？
好吧，也许不排除，也许在属性(property)附近有一些评论，但仅针对该回复。

Answer 1

为了使用自定义对象扩展 Swagger 模式，该字段必须以 x- 开头。

在此处查看更多信息:http://swagger.io/specification/#vendorExtensions

例如，swagger-node 使用 x-swagger-router-controller指定用于特定 API 路径的 Controller 。但是你可以将它用于任何你需要的地方，例如，x-custom-property