reference - 是否可以定义参数集并引用它？

Question

我有多个要引用的参数，但不想一一指定。

此代码段不会显示参数:

{
    ...
    "paths": {
        "/stuff": {
            "get": {
                "description": "Gets stuff",
                "operationId": "getStuff",
                "parameters": {
                    "$ref": "#/definitions/set1"
                }
            }
        }
    },
    "parameters": {
        "a": {
            "name": "a",
            "in": "query",
            "description": "Param A",
            "required": false,
            "type": "string"
        },
        "b": {
            "name": "b",
            "in": "query",
            "description": "Param B",
            "required": false,
            "type": "string"
        }
    },
    "definitions": {
        "set1": [
            {
                "$ref": "#/parameters/a"
            },
            {
                "$ref": "#/parameters/b"
            }
       ],
       "set2": ...
    }
}

这是可能的还是我必须指定每个参数，如 set1 ，对于每个请求？

Answer 1

事实上，这不是一个有效的定义，正如您所建议的，您必须通过引用全局参数来单独指定每个参数。如果您的参数为特定路径下的所有操作共享，您可以在路径级别定义这些参数，它们将应用于所有操作。

对于单个操作，您可以将其定义为:

"paths": {
  "/stuff": {
    "get": {
      "description": "Gets stuff",
      "operationId": "getStuff",
      "parameters": [
        {
          "$ref": "#/parameters/a"
        },
        {
          "$ref": "#/parameters/b"
        }
      ]
    }
  }
}