如何在OpenAPI 3.0中的对象中至少需要一个属性？

Question

我有此OpenAPI架构：

components:
  schemas:
    User:
      type: object
      required:
        - username
        - email
        - description
        - profile_icon
      properties:
        username
          type: string
        email
          type: string
          format: email
        description
          type: string
        profile_icon
          type: string

所有属性都是必需的。这是put/user/profile。

我将将其更改为补丁/用户/配置文件。 用户仅发送参数仅要求更改。 系统验证至少需要一个参数。

我如何描述需要一个[用户名，电子邮件，描述，profile_icon]？

可接受的示例请求：

{
  "username": "Will Smith"
}

{
  "email": "[email protected]",
  "profile_icon": "aaaaa.png"
}

不可接受的示例（错误）：

{}

anyof注释器已接近，但似乎仅适用于$ ref schemas，而不是属性。

htttps://swagger.io/docs.io/docs/specification/data--data-------模型/单一单独/

Answer 1

在对象中至少需要1个属性的最简单方法是使用minproperties：1。

    User:
      type: object
      minProperties: 1   # <--------
      properties:
        username:
          type: string
        ...