swagger - 是否可以覆盖某些参数定义属性？

Question

我有一个通用参数，我想将其用于查询和路径。

parameters:
   idParam:
      name: ID
      description: The ID of the object
      required: false
      type: number
      format: int32

有没有一种方法可以在两种情况下重用一个参数，并像下面所做的那样仅更改“ in”属性，还是必须进行2个单独的参数定义？

/path:
    paramInQueryString:
        get:
            parameters:
                - $ref: "#/parameters/idParam"
                    - in: query
    paramInQueryPath/{ID}:
        get:
            parameters:
                - $ref: "#/parameters/idParam"
                    - in: path

Answer 1

可重用参数对象将在OpenAPI spec 3.0中引入。有关更多信息，请参考https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/versions/3.0.md#components-object =>“ Parameters Definitions Object”。