Swagger编辑器如何指定请求正文POST中需要哪些字段？

我正在尝试在在线Swagger编辑器中的用户类上定义POST方法。

我希望能够在请求正文中指定多个字段，并且希望生成的文档反映仅2个字段是必需的，其他是可选的。

要做到这一点，我必须做什么/更改？

我尝试使用“ required”关键字进行各种变体（请参见下图），但无法进行该工作，它不会显示在生成的文档中（请参见右下图）我的注释为红色）。

这是我在编辑器中的POST定义：

这是生成的文档预览，在该文档中，我指出了我希望更改的内容。

PS。还有更多（较旧的）帖子可以解决这个问题，但是我真的不认为这是重复的。

我希望能够在请求正文中指定多个字段，并且希望生成的文档反映仅2个字段是必需的，其他是可选的。

您的第二个示例是正确的。要指定所需的对象属性，请在对象级别上添加required: [prop1,prop2,...]（即，在type: object旁边）。 required列表中未列出的属性是可选的。如果未提供required列表，则所有属性都是可选的。

type: object
required: [email,password]  # <--------
properties:
  email:
    type: string
  password:
    type: string
  name:
    type: string

在Swagger UI中，特定于操作的架构文档显示在 Schema （或 Model ）选项卡上。在此处显示属性描述，数据类型，“必需”指示符和其他架构信息。

enter image description here

现在，我必须弄清楚如何将“模式”显示为默认值

要默认启用 Schema / Model 标签，请在Swagger UI上将defaultModelRendering选项设置为"model"。