Wie gruppiert man mehrere Parameter in Swagger 2.0?

Question

Ist es möglich, mehrere Parameter zu gruppieren, um sie in mehreren Routen zu referenzieren?

Zum Beispiel habe ich eine Kombination von Parametern, die ich in jeder Route brauche. Sie sind als globale Parameter definiert. Wie kann ich sie gruppieren?

Ich denke über eine Definition wie folgt aus:

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 

Und dann die ganze Gruppe in meiner Route Referenz:

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

Ist dies möglich mit Swagger 2.0?

Answer 1

Dies ist mit Swagger im Moment nicht möglich (Version 2.0). Ich habe ein Feature-Request für diese geöffnet und es wird für die nächste Version vorgeschlagen:

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