要求数组在Swagger架构对象定义中至少包含一个元素

Question

在我的< code>swagger.yaml中有一个这样的模式对象定义:

User:
  type: object
  properties:
    username:
      type: string
      description: the user name
    colors:
      type: array
      items: {
        type: string,
        enum: [ "red", "blue", "green" ]
      }
      description: user must have one or more colors associated
  required:
    - username
    - colors

但是，生成的服务器仍然乐意接受使用此模式对象作为不包含任何颜色字段的必需主体参数的POST请求。

我是否可以这样配置Swagger：＜code＞颜色＜/code＞字段在＜code＞用户

Answer 1

使用最小项：1。此外，您可以在数组中强制执行uniqueItems。

    colors:
      type: array
      minItems: 1
      uniqueItems: true
      items:
        type: string
        enum: [ "red", "blue", "green" ]