refine swagger2 parameter types (#30452)

types/swagger-schema-official/index.d.ts

@@ -87,7 +87,7 @@ export interface Path {
   options?: Operation;
   head?: Operation;
   patch?: Operation;
-  parameters?: Parameter[] | Reference[];
+  parameters?: Array<Parameter | Reference>;
 }
 
 // ----------------------------- Operation -----------------------------------
@@ -99,7 +99,7 @@ export interface Operation {
   operationId?: string;
   produces?: string[];
   consumes?: string[];
-  parameters?: Parameter[] | Reference[];
+  parameters?: Array<Parameter | Reference>;
   schemes?: string[];
   deprecated?: boolean;
   security?: Security[];

types/swagger-schema-official/swagger-schema-official-tests.ts

@@ -1365,7 +1365,13 @@ const reference_support: swagger.Spec = {
         "/path": {
             "get": {
                 "parameters": [
-                    {"$ref": "#/parameters/operationParameter"}
+                    {"$ref": "#/parameters/operationParameter"},
+                    {
+                        "in": "body",
+                        "name": "bodyParameter",
+                        "type": "string",
+                        "description": "The body parameter"
+                    }
                 ],
                 "responses": {
                     "200": {
@@ -1380,7 +1386,13 @@ const reference_support: swagger.Spec = {
                 }
             },
             "parameters": [
-                {"$ref": "#/parameters/pathParameter"}
+                {"$ref": "#/parameters/pathParameter"},
+                {
+                    "in": "query",
+                    "name": "queryParameter",
+                    "type": "string",
+                    "description": "Another query parameter"
+                }
             ]
         }
     },