この機能はSwagger2.0にすでに存在します。リンクされたチケットは、この機能の機能に影響を与えない、その特定のメカニズムについて説明しています。
最上位のオブジェクト(Swaggerオブジェクトと呼ばれる)には、parameters
再利用可能なパラメーターを定義できるプロパティがあります。パラメータには任意の名前を付けて、パス/特定の操作から参照できます。トップレベルのパラメータは単なる定義であり、仕様のすべての操作に自動的に適用されるわけではありません。
ここでその例を見つけることができます--https://github.com/swagger-api/swagger-spec/blob/master/fixtures/v2.0/json/resources/reusableParameters.json-制限パラメーターがあっても。
あなたの場合、あなたはこれをしたいと思うでしょう:
/path:
get:
parameters:
- $ref: "#/parameters/limitParam"
- $ref: "#/parameters/offsetParam"
parameters:
limitParam:
name: limit
in: query
description: Limits the number of returned results
required: false
type: integer
format: int32
offsetParam:
name: offset
in: query
description: Offset from which start returned results
required: false
type: integer
format: int32