Swagger架构属性被忽略-为什么？

Question

我试图建立一个简单的招摇模型：

PlayerConfig:
  type: object
  required:
    - kind
    - player_id
  properties:
    kind:
      type: string
      example: PlayerConfig
    player_id:
      type: string
      example: "foo"
      description: "bar"

sports_config:
  oneOf:
    - $ref: '#/components/schemas/PlayerConfig'
  discriminator:
    propertyName: kind

由于某些原因，生成的HTML没有显示player_id的示例字段。这让我觉得我做得不对。s

所以问题是，使用一个模型作为一个类型是否真的可以像我试图做的那样<代码>示例如果其父字段是参数：而不是属性：，则会呈现该字段。

更新：我阅读了对象和属性示例关于https://swagger.io/docs/specification/adding-examples/的部分，似乎我的代码片段应该已经工作了。

Answer 1

如果字符串值包含空格（或其他一些特殊字符），您应该将其括在引号中。所以该行应该是

  example: "LeBron James"