Как сгруппировать несколько параметров в Swagger 2.0?

можно ли сгруппировать несколько параметров, чтобы ссылаться на них в несколько маршрутов?

например у меня есть сочетание параметров, которые мне нужны в каждом маршруте. Они определяются как глобальные параметры. Как я могу их сгруппировать?

Я думаю о таком определении:

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

а затем ссылаться на всю группу в моем маршруте:

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

возможно ли это с Swagger 2.0?

1 ответов


Это невозможно с Swagger на данный момент (версия 2.0). Я открыл запрос функции для этого, и он предлагается для следующей версии:

https://github.com/swagger-api/swagger-spec/issues/445