如何为OpenAPI查询参数指定可能的值？

Question

我想指定一个名为fields的查询参数，该参数可以作为字符串列表发送，并带有OpenAPI 3规范中的多个可能值。

即，所有这些对我而言都是有效的： fields=name fields=title,abstract fields=name,title,abstract

我本来要使用enum类型（如下所示），但是在我看来这是错误的，因为这意味着应该仅使用给定值的一个。< / p>

        "fields": {
            "name": "fields",
            "in": "query",
            "description": "The data fields to be returned from the response.",
            "required": false,
            "schema": {
                "type": "string",
                "enum": [
                    "name",
                    "title",
                    "abstract"
                ]
            }
        },

如何指定可能的有效选项列表？我必须使用pattern字段和正则表达式吗？还是有更好的方法？