È possibile definire un set di parametri e riferirlo?

Question

Ho più parametri a cui voglio fare riferimento, ma non voglio specificarli uno per uno.

Questo frammento non rende i parametri visualizzati:

{ 
    ... 
    "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": ... 
    } 
} 

Questo è possibile o devo specificare ogni parametro come set1, per ogni richiesta?

Answer 1

In effetti questa non è una definizione valida e come hai suggerito, dovresti specificare ogni parametro separatamente facendo riferimento a quello globale. Se i parametri sono condivisi per tutte le operazioni in un percorso specifico, è possibile definirli a livello di percorso e verrebbero applicati a tutte le operazioni.

Per una singola operazione, che ci definisce come:

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