swagger - Swagger 2.0中如何对多个参数进行分组？

Question

是否可以将多个参数分组以在多个路由中引用它们？

例如，我有每条路线都需要的参数组合。它们被定义为全局参数。我怎样才能将它们分组？

我想到这样的定义:

parameters:
  MetaDataParameters:
    # Meta Data Properties
    - name: id
      in: query
      description: Entry identification number
      required: false
      type: integer
    
    - name: time_start
      in: query
      description: Start time of flare
      required: false
      type: string
    
    - name: nar
      in: query
      description: Active region number
      required: false
      type: string

然后在我的 route 引用整个组:

/test/:
  get:
    tags:
      - TEST
    operationId: routes.test
    parameters:
      - $ref: "#/parameters/MetaDataParameters"
    responses:
        200:
          description: OK

Swagger 2.0 可以做到这一点吗？

Answer 1

这对于 Swagger 2.0、OpenAPI 3.0 或 3.1 来说是不可能的。我已经为此提出了一个功能请求，并建议在未来版本中使用:

https://github.com/OAI/OpenAPI-Specification/issues/445