背景 2017/7にSwaggerはOpenAPI Specificationとして生まれ変わりました。 正確にはSwaggerの開発元(?)であるSMATRBEAR SoftwareがSwagger2.0をOpen API Initiativeに寄贈し、それを元にOpenAPI Specification(以下OAS) 3.0が作られました。 Swagger2.0と比較してOAS3.0では様々な拡張とリファクタリングが行われましたが、その中でParameter Objectについて記法がかなり拡張されたのでそれについて書きたいと思います。 そもそもSwagger(OAS)って何? こちらの記事でも述べましたが、この時と多少変わっているので、 https://swagger.io/specification/ から引用します。 The OpenAPI Specification (OAS)