swagger-core 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 504f9a4a59a9375122f41ce9f860d4ba987794cf
-  data.tar.gz: 188dd67ba02fac3c733a576a446daba3b8328aa4
+  metadata.gz: f3af93efcb0f85951fb9df1b336a6cda8734ff54
+  data.tar.gz: 55e2097921aed8e3a23af1e5e6dc3d1c9b53399d
 SHA512:
-  metadata.gz: a9296b2964903801be8427af3f6a59e2a67c6fe8612c8be3c0bf634166584208d7732a0c8aeefcb10f3a6434114f4e34d8015a4eaa01bf08875ba3202bed678f
-  data.tar.gz: 7aea8b5d5d3f074fa856545d69b0c72b2d5d9d4df84c7b1c0c26e040e8cc81761411cf61e6835a7ff5c30cda0f92c6a5324149dc7e0634365f130c315fa707a3
+  metadata.gz: d86f0c184cf88efc692b1201a0a61acb25bd1cbf29054572fdd2729c0e0b115fade5f13d1087f2e532bd344fda28da818a2f6b3db12543ca5ce6d449448fad0e
+  data.tar.gz: 994786ab4d0b7bcd30024b0e29212c6e4bb47284e5b8e1ce4301edc567ea1209cfeefee9fad254159376b4e8e2bd9323f04833cba7bb3f34a805156f87959132

data/lib/swagger.rb

@@ -1,4 +1,5 @@
 require 'swagger/version'
+require 'swagger/boolean'
 require 'addressable/uri'
 require 'addressable/template'
 require 'hashie'

data/lib/swagger/boolean.rb

@@ -0,0 +1,13 @@
+module Swagger
+  class Boolean
+    TRUE_REGEXP = /(y|Y|yes|Yes|YES|true|True|TRUE|on|On|ON)/
+    FALSE_REGEXP = /(n|N|no|No|NO|false|False|FALSE|off|Off|OFF)/
+
+    def self.coerce(obj)
+      val = obj.to_s.downcase
+      return true if val.match(TRUE_REGEXP)
+      return false if val.match(FALSE_REGEXP)
+      fail ArgumentError, "#{obj} cannot be coerced to a boolean"
+    end
+  end
+end

data/lib/swagger/builder.rb

@@ -19,7 +19,7 @@ module Swagger
     end
 
     # @api private
-    def self.included(dash) # rubocop:disable Metrics/MethodLength
+    def self.included(dash) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
       fail TypeError, 'Bash only works on Dash' unless dash <= Hashie::Dash
       dash.extend ClassMethods
       dash.instance_variable_get('@required_properties').clear

data/lib/swagger/v2/api.rb

@@ -1,7 +1,10 @@
 require 'swagger/swagger_object'
+require 'swagger/v2/deterministic_json_schema'
 require 'swagger/v2/info'
 require 'swagger/v2/path'
 require 'swagger/v2/tag'
+require 'swagger/v2/security_scheme'
+require 'swagger/v2/security_requirement'
 require 'json-schema'
 
 module Swagger
@@ -15,8 +18,7 @@ module Swagger
     # @see https://github.com/wordnik/swagger-spec/blob/master/versions/2.0.md#swagger-object- Swagger Object
     class API < Swagger::API
       # @group Swagger Fields
-      # HACK: Swagger-Spec: This is correct for now, but schema will likely be changed to String
-      required_field :swagger, Float
+      required_field :swagger, String
       required_field :info, Info
       field :host, Swagger::URITemplate
       field :basePath, Swagger::URITemplate
@@ -27,11 +29,10 @@ module Swagger
       field :definitions, Hash[String => Schema]
       field :parameters, Hash[String => Parameter]
       field :responses, Hash[String => Response]
-      # HACK: Swagger-Spec: Not documented/defined yet. Implement once spec is complete.
-      field :security, Object
-      # TODO: This is actually an array of tag names, not Tag objects, need to handle relation
-      field :tag, Array[String]
-      # TODO: externalDocs - Documentable Module
+      field :securityDefinitions, Hash[String => SecurityScheme]
+      field :security, Array[SecurityRequirement]
+      field :tags, Array[Object] # FIXME: This is actually an array of Tag objects
+      field :externalDocs, Object # TODO: ExternalDocs class
       # @endgroup
 
       alias_method :base_path, :basePath

data/lib/swagger/v2/deterministic_json_schema.rb

@@ -0,0 +1,130 @@
+module Swagger
+  module V2
+    # A Swagger Schema Object, which is subset of JSON-Schema that's constrainted to be more deterministic.
+    # @see https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#schema-object- Schema Object
+    # @see http://json-schema.org/ JSON-Schema
+    module DeterministicJSONSchema
+      # FIXME: yard group doesn't seem to work below
+
+      # @!group Deterministic JSON Schema
+      # @!attribute [rw] $ref
+      #     JSON-Schema field $ref.
+      #     @return String
+      # @!attribute [rw] format
+      #     JSON-Schema field format.
+      #     @return String
+      # @!attribute [rw] title
+      #     JSON-Schema field title.
+      #     @return String
+      # @!attribute [rw] description
+      #     JSON-Schema field description.
+      #     @return String
+      # @!attribute [rw] default
+      #     JSON-Schema field default.
+      #     @return Object
+      # @!attribute [rw] multipleOf
+      #     JSON-Schema field multipleOf.
+      #     @return Object
+      # @!attribute [rw] maximum
+      #     JSON-Schema field maximum.
+      #     @return Numeric
+      # @!attribute [rw] exclusiveMaximum
+      #     JSON-Schema field exclusiveMaximum.
+      #     @return boolean
+      # @!attribute [rw] minimum
+      #     JSON-Schema field minimum.
+      #     @return Numeric
+      # @!attribute [rw] exclusiveMinimum
+      #     JSON-Schema field exclusiveMinimum.
+      #     @return boolean
+      # @!attribute [rw] minLength
+      #     JSON-Schema field minLength.
+      #     @return Integer
+      # @!attribute [rw] maxLength
+      #     JSON-Schema field maxLength.
+      #     @return Integer
+      # @!attribute [rw] pattern
+      #     JSON-Schema field pattern.
+      #     @return Regexp
+      # @!attribute [rw] minItems
+      #     JSON-Schema field minItems.
+      #     @return Integer
+      # @!attribute [rw] maxItems
+      #     JSON-Schema field maxItems.
+      #     @return Integer
+      # @!attribute [rw] uniqueItems
+      #     JSON-Schema field uniqueItems.
+      #     @return boolean
+      # @!attribute [rw] maxProperties
+      #     JSON-Schema field maxProperties.
+      #     @return Integer
+      # @!attribute [rw] minProperties
+      #     JSON-Schema field minProperties.
+      #     @return Integer
+      # @!attribute [rw] required
+      #     JSON-Schema field required.
+      #     @return boolean
+      # @!attribute [rw] enum
+      #     JSON-Schema field enum.
+      #     @return Array[Object]
+      # @!attribute [rw] type
+      #     JSON-Schema field type.
+      #     @return Object
+      # @!endgroup
+
+      # @!group Swagger specific extensions
+      # @!attribute [rw] discriminator
+      #     Swagger Schema field discriminator.
+      #     @return String
+      # @!attribute [rw] readOnly
+      #     Swagger Schema field readOnly.
+      #     @return boolean
+      # @!attribute [rw] xml
+      #     Swagger Schema field xml.
+      #     @return Object
+      # @!attribute [rw] externalDocs
+      #     Swagger Schema field externalDocs.
+      #     @return ExternalDocumentation
+      # @!attribute [rw] example
+      #     Swagger Schema field example.
+      #     @return Object
+      # @!endgroup
+
+      def self.included(base) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        # Subset of standard JSON schema
+        base.field :$ref, String
+        base.field :format, String
+        base.field :title, String
+        base.field :description, String
+        base.field :default, Object
+        base.field :multipleOf, Numeric
+        base.field :maximum, Numeric
+        base.field :exclusiveMaximum, Swagger::Boolean
+        base.send(:alias_method, :exclusiveMaximum?, :exclusiveMaximum)
+        base.field :minimum, Numeric
+        base.field :exclusiveMinimum, Swagger::Boolean
+        base.send(:alias_method, :exclusiveMinimum?, :exclusiveMinimum)
+        base.field :maxLength, Integer
+        base.field :minLength, Integer
+        base.field :pattern, String
+        base.field :maxItems, Integer
+        base.field :minItems, Integer
+        base.field :uniqueItems, Swagger::Boolean
+        base.send(:alias_method, :uniqueItems?, :uniqueItems)
+        base.field :maxProperties, Integer
+        base.field :minProperties, Integer
+        base.field :required, Swagger::Boolean
+        base.send(:alias_method, :required?, :required)
+        base.field :enum, Array[Object]
+        base.field :type, Object
+
+        # Swagger extensions to JSON schema :\
+        base.field :discriminator, String
+        base.field :readOnly, Swagger::Boolean
+        base.field :xml, Object # TODO: Swagger XML object / XML support
+        base.field :externalDocs, Object # TODO: ExternalDocumentation class
+        base.field :example, Object
+      end
+    end
+  end
+end

data/lib/swagger/v2/example.rb

@@ -20,7 +20,7 @@ module Swagger
       # @return [Object] an object according to the +media_type+
       def parse(media_type = 'application/json')
         return @raw unless @raw.is_a? String
-        parser = Swagger::MIMEType.parser_for(media_type)
+        parser = Swagger::MimeType.parser_for(media_type)
         parser.parse(@raw)
       end
 

data/lib/swagger/v2/header.rb

@@ -0,0 +1,22 @@
+require 'swagger/swagger_object'
+
+module Swagger
+  module V2
+    # Class representing a Swagger "Header Object".
+    # @see https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#headerObject Header Object
+    class Header < SwaggerObject
+      # @!group Fixed Fields
+      field :description, String
+      field :required, Swagger::Boolean
+      alias_method :required?, :required
+      field :type, String
+      field :format, String
+      field :items, Hash # TODO: Items Object
+      field :collectionFormat, String
+      field :default, Object
+      # @!endgroup
+
+      include DeterministicJSONSchema
+    end
+  end
+end

data/lib/swagger/v2/operation.rb

@@ -1,6 +1,7 @@
 require 'swagger/swagger_object'
 require 'swagger/v2/parameter'
 require 'swagger/v2/response'
+require 'swagger/v2/security_requirement'
 
 module Swagger
   module V2
@@ -10,19 +11,18 @@ module Swagger
       extend Forwardable
       def_delegators :parent, :uri_template, :path, :host
 
-      # required_field :verb, Symbol
       field :summary, String
       field :description, String
       field :operationId, String
       alias_method :operation_id, :operationId
-      field :produces, Array[String]
-      field :consumes, Array[String]
-      field :tags, Array[String]
-      field :parameters, Array[Parameter]
+      field :produces, Array[String] # TODO: Need a lookup that merges w/ API-level field
+      field :consumes, Array[String] # TODO: Need a lookup that merges w/ API-level field
+      field :tags, Array[String] # TODO: This is an array of tag names, need to handle resolution name -> Tag object
+      field :parameters, Array[Parameter] # TODO: Can't decide if default: [] is useful or troublesome
       field :responses, Hash[String => Response]
-      field :schemes, Array[String]
-
-      # TODO: Add externalDocs
+      field :schemes, Array[String] # TODO: Need a lookup that merges w/ API-level field
+      field :security, Array[SecurityRequirement] # TODO: Need a lookup that merges w/ API-level field
+      field :externalDocs, Object # TODO: ExternalDocumentation class
 
       def api_title
         root.info.title
@@ -32,6 +32,7 @@ module Swagger
         "#{api_title} - #{summary}"
       end
 
+      # The HTTP verb for the operation.
       def verb
         parent.operations.key self
       end
@@ -47,6 +48,18 @@ module Swagger
         # In the examples, default is actually an error
         responses['200'] || responses['201'] || responses['default'] || responses.values.first
       end
+
+      # Iterates over each parameter defined directly on the operation, excluding parameters
+      # defined at the API level.
+      def each_parameter
+        return if parameters.nil?
+        parameters.each do | parameter |
+          yield parameter
+        end
+      end
+
+      # Iterates over all parameters defined on this operation or at the API level
+      # TODO: Implement all_parameters
     end
   end
 end

data/lib/swagger/v2/parameter.rb

@@ -10,7 +10,8 @@ module Swagger
       # required_field :in, String
       field :in, String
       field :description, String
-      field :required, Object # FIXME: Should be a boolean
+      field :required, Swagger::Boolean
+      alias_method :required?, :required
       # @!endgroup
 
       # @!group Body Fields
@@ -25,21 +26,7 @@ module Swagger
       field :default, Object
       # @!endgroup
 
-      # @!group Deterministic JSON Schema
-      field :default, Object
-      field :maximum, Numeric
-      field :exclusiveMaximum, String # FIXME: boolean
-      field :minimum, Numeric
-      field :exclusiveMinimum,  String # FIXME: boolean
-      field :maxLength, Integer
-      field :minLength, Integer
-      field :pattern, String
-      field :maxItems,  Integer
-      field :minItems,  Integer
-      field :uniqueItems, String # FIXME: boolean
-      field :enum,  Array[Object]
-      field :multipleOf,  Numeric
-      # @!endgroup
+      include DeterministicJSONSchema
     end
   end
 end

data/lib/swagger/v2/path.rb

@@ -34,6 +34,14 @@ module Swagger
       def path
         parent.paths.key self
       end
+
+      # Iterates over each Path level parameter.
+      def each_parameter
+        return if parameters.nil?
+        parameters.each do | parameter |
+          yield parameter
+        end
+      end
     end
   end
 end

data/lib/swagger/v2/response.rb

@@ -1,5 +1,6 @@
 require 'swagger/swagger_object'
 require 'swagger/v2/example'
+require 'swagger/v2/header'
 
 module Swagger
   module V2
@@ -8,7 +9,7 @@ module Swagger
     class Response < SwaggerObject
       field :description, String
       field :schema, Swagger::Schema
-      field :headers, Array # [String => String] # TODO: Headers
+      field :headers, Hash[String => Header] # TODO: Headers
       field :examples, Hash[Swagger::MimeType => Example]
 
       def status_code

data/lib/swagger/v2/security_requirement.rb

@@ -0,0 +1,12 @@
+require 'swagger/swagger_object'
+
+module Swagger
+  module V2
+    # Class representing a Swagger "Security Requirement Object".
+    # @see https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#securityRequirementObject
+    #   Security Requirement Object
+    class SecurityRequirement < Hashie::Mash
+      # TODO: Need proper constraints, but coercion is tricky
+    end
+  end
+end

data/lib/swagger/v2/security_scheme.rb

@@ -0,0 +1,25 @@
+require 'swagger/swagger_object'
+
+module Swagger
+  module V2
+    # Class representing a Swagger "Security Scheme Object".
+    # @see https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#securitySchemeObject
+    #   Security Scheme Object
+    class SecurityScheme < SwaggerObject
+      # FIXME: Swagger documentation about what's required doesn't seem accurate - OSAuth2 centric?
+
+      # According to docs, all except description are required. Schema and samples don't match.
+
+      # @!group Fixed Fields
+      required_field :type, String
+      field :description, String
+      field :name, String
+      field :in, String
+      required_field :flow, String
+      required_field :authorizationUrl, String
+      field :tokenUrl, String
+      required_field :scopes, Hash
+      # @!endgroup
+    end
+  end
+end

data/lib/swagger/version.rb

@@ -1,3 +1,3 @@
 module Swagger
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

data/resources/schemas/swagger/v2.0/schema.json

@@ -1,9 +1,13 @@
 {
   "title": "A JSON Schema for Swagger 2.0 API.",
+  "id": "http://swagger.io/v2/schema.json#",
   "$schema": "http://json-schema.org/draft-04/schema#",
-
   "type": "object",
-  "required": [ "swagger", "info", "paths" ],
+  "required": [
+    "swagger",
+    "info",
+    "paths"
+  ],
   "additionalProperties": false,
   "patternProperties": {
     "^x-": {
@@ -12,20 +16,19 @@
   },
   "properties": {
     "swagger": {
-      "type": "number",
-      "enum": [ 2.0 ],
+      "type": "string",
+      "enum": [
+        "2.0"
+      ],
       "description": "The Swagger version of this document."
     },
     "info": {
       "$ref": "#/definitions/info"
     },
-    "externalDocs": {
-      "$ref": "#/definitions/externalDocs"
-    },
     "host": {
       "type": "string",
       "format": "uri",
-      "pattern": "^((?!\\:\/\/).)*$",
+      "pattern": "^[^{}/ :\\\\]+(?::\\d+)?$",
       "description": "The fully qualified URI to the host of the API."
     },
     "basePath": {
@@ -34,78 +37,53 @@
       "description": "The base path to the API. Example: '/api'."
     },
     "schemes": {
-      "type": "array",
-      "description": "The transfer protocol of the API.",
-      "items": {
-        "type": "string",
-        "enum": [ "http", "https", "ws", "wss" ]
-      }
+      "$ref": "#/definitions/schemesList"
     },
     "consumes": {
-      "type": "array",
       "description": "A list of MIME types accepted by the API.",
-      "items": {
-        "$ref": "#/definitions/mimeType"
-      }
+      "$ref": "#/definitions/mediaTypeList"
     },
     "produces": {
-      "type": "array",
       "description": "A list of MIME types the API can produce.",
-      "items": {
-        "$ref": "#/definitions/mimeType"
-      }
+      "$ref": "#/definitions/mediaTypeList"
     },
     "paths": {
-      "type": "object",
-      "description": "Relative paths to the individual endpoints. They must be relative to the 'basePath'.",
-      "patternProperties": {
-        "^x-": {
-          "$ref": "#/definitions/vendorExtension"
-        },
-        "^\/$|^\/.*[^\/]$": {
-          "$ref": "#/definitions/pathItem"
-        }
-      },
-      "additionalProperties": false
+      "$ref": "#/definitions/paths"
     },
     "definitions": {
-      "type": "object",
-      "description": "One or more JSON objects describing the schemas being consumed and produced by the API.",
-      "additionalProperties": { "$ref": "#/definitions/schema" }
+      "$ref": "#/definitions/definitions"
     },
     "parameters": {
-      "type": "object",
-      "description": "One or more JSON representations for parameters",
-      "additionalProperties": { "$ref": "#/definitions/parameter" }
+      "$ref": "#/definitions/parameterDefinitions"
+    },
+    "responses": {
+      "$ref": "#/definitions/responseDefinitions"
+    },
+    "security": {
+      "$ref": "#/definitions/security"
+    },
+    "securityDefinitions": {
+      "$ref": "#/definitions/securityDefinitions"
     },
-    "responses": { "$ref": "#/definitions/responses" },
-    "security": { "$ref": "#/definitions/security" },
     "tags": {
       "type": "array",
       "items": {
         "$ref": "#/definitions/tag"
-      }
+      },
+      "uniqueItems": true
+    },
+    "externalDocs": {
+      "$ref": "#/definitions/externalDocs"
     }
   },
   "definitions": {
-    "externalDocs": {
-      "type": "object",
-      "description": "information about external documentation",
-      "required": [ "url" ],
-      "properties": {
-        "description": {
-          "type": "string"
-        },
-        "url": {
-          "type": "string",
-          "format": "uri"
-        }
-      }
-    },
     "info": {
       "type": "object",
       "description": "General information about the API.",
-      "required": [ "version", "title" ],
+      "required": [
+        "version",
+        "title"
+      ],
       "additionalProperties": false,
       "patternProperties": {
         "^x-": {
@@ -113,14 +91,14 @@
         }
       },
       "properties": {
-        "version": {
-          "type": "string",
-          "description": "A semantic version number of the API."
-        },
         "title": {
           "type": "string",
           "description": "A unique and precise title of the API."
         },
+        "version": {
+          "type": "string",
+          "description": "A semantic version number of the API."
+        },
         "description": {
           "type": "string",
           "description": "A longer description of the API. Should be different from the title.  Github-flavored markdown is allowed."
@@ -130,45 +108,104 @@
           "description": "The terms of service for the API."
         },
         "contact": {
-          "type": "object",
-          "description": "Contact information for the owners of the API.",
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "type": "string",
-              "description": "The identifying name of the contact person/organization."
-            },
-            "url": {
-              "type": "string",
-              "description": "The URL pointing to the contact information.",
-              "format": "uri"
-            },
-            "email": {
-              "type": "string",
-              "description": "The email address of the contact person/organization.",
-              "format": "email"
-            }
-          }
+          "$ref": "#/definitions/contact"
         },
         "license": {
-          "type": "object",
-          "required": [ "name" ],
-          "additionalProperties": false,
-          "properties": {
-            "name": {
-              "type": "string",
-              "description": "The name of the license type. It's encouraged to use an OSI compatible license."
-            },
-            "url": {
-              "type": "string",
-              "description": "The URL pointing to the license.",
-              "format": "uri"
-            }
-          }
+          "$ref": "#/definitions/license"
+        }
+      }
+    },
+    "contact": {
+      "type": "object",
+      "description": "Contact information for the owners of the API.",
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The identifying name of the contact person/organization."
+        },
+        "url": {
+          "type": "string",
+          "description": "The URL pointing to the contact information.",
+          "format": "uri"
+        },
+        "email": {
+          "type": "string",
+          "description": "The email address of the contact person/organization.",
+          "format": "email"
+        }
+      }
+    },
+    "license": {
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the license type. It's encouraged to use an OSI compatible license."
+        },
+        "url": {
+          "type": "string",
+          "description": "The URL pointing to the license.",
+          "format": "uri"
+        }
+      }
+    },
+    "paths": {
+      "type": "object",
+      "description": "Relative paths to the individual endpoints. They must be relative to the 'basePath'.",
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        },
+        "^/": {
+          "$ref": "#/definitions/pathItem"
+        }
+      },
+      "additionalProperties": false
+    },
+    "definitions": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/schema"
+      },
+      "description": "One or more JSON objects describing the schemas being consumed and produced by the API."
+    },
+    "parameterDefinitions": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/parameter"
+      },
+      "description": "One or more JSON representations for parameters"
+    },
+    "responseDefinitions": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/response"
+      },
+      "description": "One or more JSON representations for parameters"
+    },
+    "externalDocs": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "information about external documentation",
+      "required": [
+        "url"
+      ],
+      "properties": {
+        "description": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri"
         }
       }
     },
-    "example": {
+    "examples": {
       "type": "object",
       "patternProperties": {
         "^[a-z0-9-]+/[a-z0-9\\-+]+$": {}
@@ -182,7 +219,9 @@
     },
     "operation": {
       "type": "object",
-      "required": [ "responses" ],
+      "required": [
+        "responses"
+      ],
       "additionalProperties": false,
       "patternProperties": {
         "^x-": {
@@ -194,7 +233,8 @@
           "type": "array",
           "items": {
             "type": "string"
-          }
+          },
+          "uniqueItems": true
         },
         "summary": {
           "type": "string",
@@ -212,54 +252,28 @@
           "description": "A friendly name of the operation"
         },
         "produces": {
-          "type": "array",
           "description": "A list of MIME types the API can produce.",
-          "additionalItems": false,
-          "items": {
-            "$ref": "#/definitions/mimeType"
-          }
+          "$ref": "#/definitions/mediaTypeList"
         },
         "consumes": {
-          "type": "array",
           "description": "A list of MIME types the API can consume.",
-          "additionalItems": false,
-          "items": {
-            "$ref": "#/definitions/mimeType"
-          }
+          "$ref": "#/definitions/mediaTypeList"
         },
         "parameters": {
-          "type": "array",
-          "description": "The parameters needed to send a valid API call.",
-          "minItems": 1,
-          "additionalItems": false,
-          "items": {
-            "oneOf": [
-              { "$ref": "#/definitions/parameter" },
-              {
-                "type": "object",
-                "additionalProperties": false,
-                "properties": {
-                  "$ref": {
-                    "type": "string"
-                  }
-                }
-              }
-            ]
-          }
+          "$ref": "#/definitions/parametersList"
         },
         "responses": {
           "$ref": "#/definitions/responses"
         },
         "schemes": {
-          "type": "array",
-          "description": "The transfer protocol of the API.",
-          "items": {
-            "type": "string",
-            "enum": [ "http", "https", "ws", "wss" ]
-          }
+          "$ref": "#/definitions/schemesList"
+        },
+        "deprecated": {
+          "type": "boolean",
+          "default": false
         },
         "security": {
-          "$ref": "#/definitions/securityRequirement"
+          "$ref": "#/definitions/security"
         }
       }
     },
@@ -297,10 +311,7 @@
           "$ref": "#/definitions/operation"
         },
         "parameters": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/parameter"
-          }
+          "$ref": "#/definitions/parametersList"
         }
       }
     },
@@ -310,17 +321,38 @@
       "minProperties": 1,
       "additionalProperties": false,
       "patternProperties": {
-        "^([0-9]+)$|^(default)$": {
-          "$ref": "#/definitions/response"
+        "^([0-9]{3})$|^(default)$": {
+          "$ref": "#/definitions/responseValue"
         },
         "^x-": {
           "$ref": "#/definitions/vendorExtension"
         }
+      },
+      "not": {
+        "type": "object",
+        "additionalProperties": false,
+        "patternProperties": {
+          "^x-": {
+            "$ref": "#/definitions/vendorExtension"
+          }
+        }
       }
     },
+    "responseValue": {
+      "oneOf": [
+        {
+          "$ref": "#/definitions/response"
+        },
+        {
+          "$ref": "#/definitions/jsonReference"
+        }
+      ]
+    },
     "response": {
       "type": "object",
-      "required": [ "description" ],
+      "required": [
+        "description"
+      ],
       "properties": {
         "description": {
           "type": "string"
@@ -329,30 +361,86 @@
           "$ref": "#/definitions/schema"
         },
         "headers": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/serializableType"
-          }
+          "$ref": "#/definitions/headers"
         },
         "examples": {
-          "$ref": "#/definitions/example"
+          "$ref": "#/definitions/examples"
         }
       },
       "additionalProperties": false
     },
-    "serializableType": {
+    "headers": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/definitions/header"
+      }
+    },
+    "header": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type"
+      ],
       "properties": {
         "type": {
           "type": "string",
-          "enum": [ "string", "number", "boolean", "integer", "array", "file" ]
+          "enum": [
+            "string",
+            "number",
+            "integer",
+            "boolean",
+            "array"
+          ]
         },
         "format": {
           "type": "string"
         },
         "items": {
-          "type": "object"
+          "$ref": "#/definitions/primitivesItems"
         },
         "collectionFormat": {
+          "$ref": "#/definitions/collectionFormat"
+        },
+        "default": {
+          "$ref": "#/definitions/default"
+        },
+        "maximum": {
+          "$ref": "#/definitions/maximum"
+        },
+        "exclusiveMaximum": {
+          "$ref": "#/definitions/exclusiveMaximum"
+        },
+        "minimum": {
+          "$ref": "#/definitions/minimum"
+        },
+        "exclusiveMinimum": {
+          "$ref": "#/definitions/exclusiveMinimum"
+        },
+        "maxLength": {
+          "$ref": "#/definitions/maxLength"
+        },
+        "minLength": {
+          "$ref": "#/definitions/minLength"
+        },
+        "pattern": {
+          "$ref": "#/definitions/pattern"
+        },
+        "maxItems": {
+          "$ref": "#/definitions/maxItems"
+        },
+        "minItems": {
+          "$ref": "#/definitions/minItems"
+        },
+        "uniqueItems": {
+          "$ref": "#/definitions/uniqueItems"
+        },
+        "enum": {
+          "$ref": "#/definitions/enum"
+        },
+        "multipleOf": {
+          "$ref": "#/definitions/multipleOf"
+        },
+        "description": {
           "type": "string"
         }
       }
@@ -362,171 +450,1034 @@
       "additionalProperties": true,
       "additionalItems": true
     },
-    "parameter": {
-      "type": "object",
-      "required": [ "name", "in" ],
-      "oneOf": [
-        {
-          "patternProperties": {
-            "^x-": {
-              "$ref": "#/definitions/vendorExtension"
-            }
-          },
-          "properties": {
-            "name": {
-              "type": "string",
-              "description": "The name of the parameter."
-            },
-            "in": {
-              "type": "string",
-              "description": "Determines the location of the parameter.",
-              "enum": [ "query", "header", "path", "formData" ]
-            },
-            "description": {
-              "type": "string",
-              "description": "A brief description of the parameter. This could contain examples of use.  Github-flavored markdown is allowed."
-            },
-            "required": {
-              "type": "boolean",
-              "description": "Determines whether or not this parameter is required or optional."
-            },
-            "type": {
-              "type": "string",
-              "enum": [ "string", "number", "boolean", "integer", "array" ]
-            },
-            "format": {
-              "type": "string"
-            },
-            "items": {
-              "type": "object"
-            },
-            "collectionFormat": {
-              "type": "string"
-            }
-          },
-          "additionalProperties": false
-        },
-        {
-          "patternProperties": {
-            "^x-": {
-              "$ref": "#/definitions/vendorExtension"
-            }
-          },
-          "properties": {
-            "name": {
-              "type": "string",
-              "description": "The name of the parameter."
-            },
-            "in": {
-              "type": "string",
-              "description": "Determines the location of the parameter.",
-              "enum": [ "body" ]
-            },
-            "description": {
-              "type": "string",
-              "description": "A brief description of the parameter. This could contain examples of use."
-            },
-            "required": {
-              "type": "boolean",
-              "description": "Determines whether or not this parameter is required or optional."
-            },
-            "schema": {
-              "$ref": "#/definitions/schema"
-            }
-          },
-          "additionalProperties": false
-        }
-      ]
-    },
-    "schema": {
+    "bodyParameter": {
       "type": "object",
-      "description": "A deterministic version of a JSON Schema object.",
+      "required": [
+        "name",
+        "in",
+        "schema"
+      ],
       "patternProperties": {
         "^x-": {
           "$ref": "#/definitions/vendorExtension"
         }
       },
       "properties": {
-        "$ref": { "type": "string" },
-        "format": { "type": "string" },
-        "title": { "$ref": "http://json-schema.org/draft-04/schema#/properties/title" },
-        "description": { "$ref": "http://json-schema.org/draft-04/schema#/properties/description" },
-        "default": { "$ref": "http://json-schema.org/draft-04/schema#/properties/default" },
-        "multipleOf": { "$ref": "http://json-schema.org/draft-04/schema#/properties/multipleOf" },
-        "maximum": { "$ref": "http://json-schema.org/draft-04/schema#/properties/maximum" },
-        "exclusiveMaximum": { "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMaximum" },
-        "minimum": { "$ref": "http://json-schema.org/draft-04/schema#/properties/minimum" },
-        "exclusiveMinimum": { "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMinimum" },
-        "maxLength": { "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger" },
-        "minLength": { "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0" },
-        "pattern": { "$ref": "http://json-schema.org/draft-04/schema#/properties/pattern" },
-        "discriminator": { "type": "string" },
-        "xml": { "$ref": "#/definitions/xml"},
-        "items": {
-          "anyOf": [
-            { "$ref": "#/definitions/schema" },
-            {
-              "type": "array",
-              "minItems": 1,
-              "items": { "$ref": "#/definitions/schema" }
-            }
-          ],
-          "default": { }
-        },
-        "maxItems": { "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger" },
-        "minItems": { "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0" },
-        "uniqueItems": { "$ref": "http://json-schema.org/draft-04/schema#/properties/uniqueItems" },
-        "maxProperties": { "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger" },
-        "minProperties": { "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0" },
-        "required": { "$ref": "http://json-schema.org/draft-04/schema#/definitions/stringArray" },
-        "externalDocs": { "$ref": "#/definitions/externalDocs" },
-        "properties": {
-          "type": "object",
-          "additionalProperties": { "$ref": "#/definitions/schema" },
-          "default": { }
+        "description": {
+          "type": "string",
+          "description": "A brief description of the parameter. This could contain examples of use.  Github-flavored markdown is allowed."
         },
-        "enum": { "$ref": "http://json-schema.org/draft-04/schema#/properties/enum" },
-        "type": { "$ref": "http://json-schema.org/draft-04/schema#/properties/type" },
-        "example": {
-
+        "name": {
+          "type": "string",
+          "description": "The name of the parameter."
         },
-        "allOf": {
-          "type": "array",
-          "minItems": 1,
-          "items": { "$ref": "#/definitions/schema" }
+        "in": {
+          "type": "string",
+          "description": "Determines the location of the parameter.",
+          "enum": [
+            "body"
+          ]
+        },
+        "required": {
+          "type": "boolean",
+          "description": "Determines whether or not this parameter is required or optional.",
+          "default": false
+        },
+        "schema": {
+          "$ref": "#/definitions/schema"
         }
-      }
-    },
-    "security": {
-      "description": "defines security definitions"
-    },
-    "securityRequirement": {
-      "description": "defines a security requirement",
-      "type": "array"
-    },
-    "xml": {
-      "properties": {
-        "name": { "type": "string"},
-        "namespace": { "type": "string" },
-        "prefix": { "type": "string" },
-        "attribute": { "type": "boolean" },
-        "wrapped": { "type": "boolean" }
       },
       "additionalProperties": false
     },
-    "tag": {
-      "type": "object",
-      "properties": {
-        "externalDocs": { "$ref": "#/definitions/externalDocs" }
-      },
+    "headerParameterSubSchema": {
+      "additionalProperties": false,
       "patternProperties": {
         "^x-": {
           "$ref": "#/definitions/vendorExtension"
+        }
+      },
+      "properties": {
+        "required": {
+          "type": "boolean",
+          "description": "Determines whether or not this parameter is required or optional.",
+          "default": false
         },
-        "^\/$|^\/.*[^\/]$": {
+        "in": {
+          "type": "string",
+          "description": "Determines the location of the parameter.",
+          "enum": [
+            "header"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "description": "A brief description of the parameter. This could contain examples of use.  Github-flavored markdown is allowed."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the parameter."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "number",
+            "boolean",
+            "integer",
+            "array"
+          ]
+        },
+        "format": {
+          "type": "string"
+        },
+        "items": {
+          "$ref": "#/definitions/primitivesItems"
+        },
+        "collectionFormat": {
+          "$ref": "#/definitions/collectionFormat"
+        },
+        "default": {
+          "$ref": "#/definitions/default"
+        },
+        "maximum": {
+          "$ref": "#/definitions/maximum"
+        },
+        "exclusiveMaximum": {
+          "$ref": "#/definitions/exclusiveMaximum"
+        },
+        "minimum": {
+          "$ref": "#/definitions/minimum"
+        },
+        "exclusiveMinimum": {
+          "$ref": "#/definitions/exclusiveMinimum"
+        },
+        "maxLength": {
+          "$ref": "#/definitions/maxLength"
+        },
+        "minLength": {
+          "$ref": "#/definitions/minLength"
+        },
+        "pattern": {
+          "$ref": "#/definitions/pattern"
+        },
+        "maxItems": {
+          "$ref": "#/definitions/maxItems"
+        },
+        "minItems": {
+          "$ref": "#/definitions/minItems"
+        },
+        "uniqueItems": {
+          "$ref": "#/definitions/uniqueItems"
+        },
+        "enum": {
+          "$ref": "#/definitions/enum"
+        },
+        "multipleOf": {
+          "$ref": "#/definitions/multipleOf"
+        }
+      }
+    },
+    "queryParameterSubSchema": {
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      },
+      "properties": {
+        "required": {
+          "type": "boolean",
+          "description": "Determines whether or not this parameter is required or optional.",
+          "default": false
+        },
+        "in": {
+          "type": "string",
+          "description": "Determines the location of the parameter.",
+          "enum": [
+            "query"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "description": "A brief description of the parameter. This could contain examples of use.  Github-flavored markdown is allowed."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the parameter."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "number",
+            "boolean",
+            "integer",
+            "array"
+          ]
+        },
+        "format": {
+          "type": "string"
+        },
+        "items": {
+          "$ref": "#/definitions/primitivesItems"
+        },
+        "collectionFormat": {
+          "$ref": "#/definitions/collectionFormatWithMulti"
+        },
+        "default": {
+          "$ref": "#/definitions/default"
+        },
+        "maximum": {
+          "$ref": "#/definitions/maximum"
+        },
+        "exclusiveMaximum": {
+          "$ref": "#/definitions/exclusiveMaximum"
+        },
+        "minimum": {
+          "$ref": "#/definitions/minimum"
+        },
+        "exclusiveMinimum": {
+          "$ref": "#/definitions/exclusiveMinimum"
+        },
+        "maxLength": {
+          "$ref": "#/definitions/maxLength"
+        },
+        "minLength": {
+          "$ref": "#/definitions/minLength"
+        },
+        "pattern": {
+          "$ref": "#/definitions/pattern"
+        },
+        "maxItems": {
+          "$ref": "#/definitions/maxItems"
+        },
+        "minItems": {
+          "$ref": "#/definitions/minItems"
+        },
+        "uniqueItems": {
+          "$ref": "#/definitions/uniqueItems"
+        },
+        "enum": {
+          "$ref": "#/definitions/enum"
+        },
+        "multipleOf": {
+          "$ref": "#/definitions/multipleOf"
+        }
+      }
+    },
+    "formDataParameterSubSchema": {
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      },
+      "properties": {
+        "required": {
+          "type": "boolean",
+          "description": "Determines whether or not this parameter is required or optional.",
+          "default": false
+        },
+        "in": {
+          "type": "string",
+          "description": "Determines the location of the parameter.",
+          "enum": [
+            "formData"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "description": "A brief description of the parameter. This could contain examples of use.  Github-flavored markdown is allowed."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the parameter."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "number",
+            "boolean",
+            "integer",
+            "array",
+            "file"
+          ]
+        },
+        "format": {
+          "type": "string"
+        },
+        "items": {
+          "$ref": "#/definitions/primitivesItems"
+        },
+        "collectionFormat": {
+          "$ref": "#/definitions/collectionFormatWithMulti"
+        },
+        "default": {
+          "$ref": "#/definitions/default"
+        },
+        "maximum": {
+          "$ref": "#/definitions/maximum"
+        },
+        "exclusiveMaximum": {
+          "$ref": "#/definitions/exclusiveMaximum"
+        },
+        "minimum": {
+          "$ref": "#/definitions/minimum"
+        },
+        "exclusiveMinimum": {
+          "$ref": "#/definitions/exclusiveMinimum"
+        },
+        "maxLength": {
+          "$ref": "#/definitions/maxLength"
+        },
+        "minLength": {
+          "$ref": "#/definitions/minLength"
+        },
+        "pattern": {
+          "$ref": "#/definitions/pattern"
+        },
+        "maxItems": {
+          "$ref": "#/definitions/maxItems"
+        },
+        "minItems": {
+          "$ref": "#/definitions/minItems"
+        },
+        "uniqueItems": {
+          "$ref": "#/definitions/uniqueItems"
+        },
+        "enum": {
+          "$ref": "#/definitions/enum"
+        },
+        "multipleOf": {
+          "$ref": "#/definitions/multipleOf"
+        }
+      }
+    },
+    "pathParameterSubSchema": {
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      },
+      "properties": {
+        "required": {
+          "type": "boolean",
+          "enum": [
+            true
+          ],
+          "description": "Determines whether or not this parameter is required or optional."
+        },
+        "in": {
+          "type": "string",
+          "description": "Determines the location of the parameter.",
+          "enum": [
+            "path"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "description": "A brief description of the parameter. This could contain examples of use.  Github-flavored markdown is allowed."
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of the parameter."
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "number",
+            "boolean",
+            "integer",
+            "array"
+          ]
+        },
+        "format": {
+          "type": "string"
+        },
+        "items": {
+          "$ref": "#/definitions/primitivesItems"
+        },
+        "collectionFormat": {
+          "$ref": "#/definitions/collectionFormat"
+        },
+        "default": {
+          "$ref": "#/definitions/default"
+        },
+        "maximum": {
+          "$ref": "#/definitions/maximum"
+        },
+        "exclusiveMaximum": {
+          "$ref": "#/definitions/exclusiveMaximum"
+        },
+        "minimum": {
+          "$ref": "#/definitions/minimum"
+        },
+        "exclusiveMinimum": {
+          "$ref": "#/definitions/exclusiveMinimum"
+        },
+        "maxLength": {
+          "$ref": "#/definitions/maxLength"
+        },
+        "minLength": {
+          "$ref": "#/definitions/minLength"
+        },
+        "pattern": {
+          "$ref": "#/definitions/pattern"
+        },
+        "maxItems": {
+          "$ref": "#/definitions/maxItems"
+        },
+        "minItems": {
+          "$ref": "#/definitions/minItems"
+        },
+        "uniqueItems": {
+          "$ref": "#/definitions/uniqueItems"
+        },
+        "enum": {
+          "$ref": "#/definitions/enum"
+        },
+        "multipleOf": {
+          "$ref": "#/definitions/multipleOf"
+        }
+      }
+    },
+    "nonBodyParameter": {
+      "type": "object",
+      "required": [
+        "name",
+        "in",
+        "type"
+      ],
+      "oneOf": [
+        {
+          "$ref": "#/definitions/headerParameterSubSchema"
+        },
+        {
+          "$ref": "#/definitions/formDataParameterSubSchema"
+        },
+        {
+          "$ref": "#/definitions/queryParameterSubSchema"
+        },
+        {
+          "$ref": "#/definitions/pathParameterSubSchema"
+        }
+      ]
+    },
+    "parameter": {
+      "oneOf": [
+        {
+          "$ref": "#/definitions/bodyParameter"
+        },
+        {
+          "$ref": "#/definitions/nonBodyParameter"
+        }
+      ]
+    },
+    "schema": {
+      "type": "object",
+      "description": "A deterministic version of a JSON Schema object.",
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      },
+      "properties": {
+        "$ref": {
+          "type": "string"
+        },
+        "format": {
+          "type": "string"
+        },
+        "title": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
+        },
+        "description": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
+        },
+        "default": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
+        },
+        "multipleOf": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/multipleOf"
+        },
+        "maximum": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/maximum"
+        },
+        "exclusiveMaximum": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMaximum"
+        },
+        "minimum": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/minimum"
+        },
+        "exclusiveMinimum": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMinimum"
+        },
+        "maxLength": {
+          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+        },
+        "minLength": {
+          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+        },
+        "pattern": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/pattern"
+        },
+        "maxItems": {
+          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+        },
+        "minItems": {
+          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+        },
+        "uniqueItems": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/uniqueItems"
+        },
+        "maxProperties": {
+          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+        },
+        "minProperties": {
+          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+        },
+        "required": {
+          "$ref": "http://json-schema.org/draft-04/schema#/definitions/stringArray"
+        },
+        "enum": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/enum"
+        },
+        "type": {
+          "$ref": "http://json-schema.org/draft-04/schema#/properties/type"
+        },
+        "items": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/schema"
+            },
+            {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "$ref": "#/definitions/schema"
+              }
+            }
+          ],
+          "default": {}
+        },
+        "allOf": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/definitions/schema"
+          }
+        },
+        "properties": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/schema"
+          },
+          "default": {}
+        },
+        "discriminator": {
+          "type": "string"
+        },
+        "readOnly": {
+          "type": "boolean",
+          "default": false
+        },
+        "xml": {
+          "$ref": "#/definitions/xml"
+        },
+        "externalDocs": {
+          "$ref": "#/definitions/externalDocs"
+        },
+        "example": {}
+      }
+    },
+    "primitivesItems": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "string",
+            "number",
+            "integer",
+            "boolean",
+            "array"
+          ]
+        },
+        "format": {
+          "type": "string"
+        },
+        "items": {
+          "$ref": "#/definitions/primitivesItems"
+        },
+        "collectionFormat": {
+          "$ref": "#/definitions/collectionFormat"
+        },
+        "default": {
+          "$ref": "#/definitions/default"
+        },
+        "maximum": {
+          "$ref": "#/definitions/maximum"
+        },
+        "exclusiveMaximum": {
+          "$ref": "#/definitions/exclusiveMaximum"
+        },
+        "minimum": {
+          "$ref": "#/definitions/minimum"
+        },
+        "exclusiveMinimum": {
+          "$ref": "#/definitions/exclusiveMinimum"
+        },
+        "maxLength": {
+          "$ref": "#/definitions/maxLength"
+        },
+        "minLength": {
+          "$ref": "#/definitions/minLength"
+        },
+        "pattern": {
+          "$ref": "#/definitions/pattern"
+        },
+        "maxItems": {
+          "$ref": "#/definitions/maxItems"
+        },
+        "minItems": {
+          "$ref": "#/definitions/minItems"
+        },
+        "uniqueItems": {
+          "$ref": "#/definitions/uniqueItems"
+        },
+        "enum": {
+          "$ref": "#/definitions/enum"
+        },
+        "multipleOf": {
+          "$ref": "#/definitions/multipleOf"
+        }
+      }
+    },
+    "security": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/securityRequirement"
+      },
+      "uniqueItems": true
+    },
+    "securityRequirement": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "uniqueItems": true
+      }
+    },
+    "xml": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "namespace": {
+          "type": "string"
+        },
+        "prefix": {
+          "type": "string"
+        },
+        "attribute": {
+          "type": "boolean",
+          "default": false
+        },
+        "wrapped": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
+    "tag": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "externalDocs": {
+          "$ref": "#/definitions/externalDocs"
+        }
+      },
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      }
+    },
+    "securityDefinitions": {
+      "type": "object",
+      "additionalProperties": {
+        "oneOf": [
+          {
+            "$ref": "#/definitions/basicAuthenticationSecurity"
+          },
+          {
+            "$ref": "#/definitions/apiKeySecurity"
+          },
+          {
+            "$ref": "#/definitions/oauth2ImplicitSecurity"
+          },
+          {
+            "$ref": "#/definitions/oauth2PasswordSecurity"
+          },
+          {
+            "$ref": "#/definitions/oauth2ApplicationSecurity"
+          },
+          {
+            "$ref": "#/definitions/oauth2AccessCodeSecurity"
+          }
+        ]
+      }
+    },
+    "basicAuthenticationSecurity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "basic"
+          ]
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      }
+    },
+    "apiKeySecurity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "name",
+        "in"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "apiKey"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "in": {
+          "type": "string",
+          "enum": [
+            "header",
+            "query"
+          ]
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      }
+    },
+    "oauth2ImplicitSecurity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "flow",
+        "authorizationUrl"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "oauth2"
+          ]
+        },
+        "flow": {
+          "type": "string",
+          "enum": [
+            "implicit"
+          ]
+        },
+        "scopes": {
+          "$ref": "#/definitions/oauth2Scopes"
+        },
+        "authorizationUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      }
+    },
+    "oauth2PasswordSecurity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "flow",
+        "tokenUrl"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "oauth2"
+          ]
+        },
+        "flow": {
+          "type": "string",
+          "enum": [
+            "password"
+          ]
+        },
+        "scopes": {
+          "$ref": "#/definitions/oauth2Scopes"
+        },
+        "tokenUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      }
+    },
+    "oauth2ApplicationSecurity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "flow",
+        "tokenUrl"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "oauth2"
+          ]
+        },
+        "flow": {
+          "type": "string",
+          "enum": [
+            "application"
+          ]
+        },
+        "scopes": {
+          "$ref": "#/definitions/oauth2Scopes"
+        },
+        "tokenUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      }
+    },
+    "oauth2AccessCodeSecurity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "flow",
+        "authorizationUrl",
+        "tokenUrl"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "oauth2"
+          ]
+        },
+        "flow": {
+          "type": "string",
+          "enum": [
+            "accessCode"
+          ]
+        },
+        "scopes": {
+          "$ref": "#/definitions/oauth2Scopes"
+        },
+        "authorizationUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "tokenUrl": {
+          "type": "string",
+          "format": "uri"
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "patternProperties": {
+        "^x-": {
+          "$ref": "#/definitions/vendorExtension"
+        }
+      }
+    },
+    "oauth2Scopes": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "mediaTypeList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/mimeType"
+      },
+      "uniqueItems": true
+    },
+    "parametersList": {
+      "type": "array",
+      "description": "The parameters needed to send a valid API call.",
+      "minItems": 1,
+      "additionalItems": false,
+      "items": {
+        "oneOf": [
+          {
+            "$ref": "#/definitions/parameter"
+          },
+          {
+            "$ref": "#/definitions/jsonReference"
+          }
+        ]
+      },
+      "uniqueItems": true
+    },
+    "schemesList": {
+      "type": "array",
+      "description": "The transfer protocol of the API.",
+      "items": {
+        "type": "string",
+        "enum": [
+          "http",
+          "https",
+          "ws",
+          "wss"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "collectionFormat": {
+      "type": "string",
+      "enum": [
+        "csv",
+        "ssv",
+        "tsv",
+        "pipes"
+      ],
+      "default": "csv"
+    },
+    "collectionFormatWithMulti": {
+      "type": "string",
+      "enum": [
+        "csv",
+        "ssv",
+        "tsv",
+        "pipes",
+        "multi"
+      ],
+      "default": "csv"
+    },
+    "title": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
+    },
+    "description": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
+    },
+    "default": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
+    },
+    "multipleOf": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/multipleOf"
+    },
+    "maximum": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/maximum"
+    },
+    "exclusiveMaximum": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMaximum"
+    },
+    "minimum": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/minimum"
+    },
+    "exclusiveMinimum": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMinimum"
+    },
+    "maxLength": {
+      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+    },
+    "minLength": {
+      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+    },
+    "pattern": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/pattern"
+    },
+    "maxItems": {
+      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
+    },
+    "minItems": {
+      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
+    },
+    "uniqueItems": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/uniqueItems"
+    },
+    "enum": {
+      "$ref": "http://json-schema.org/draft-04/schema#/properties/enum"
+    },
+    "jsonReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "$ref": {
           "type": "string"
         }
       }
     }
   }
-}
+}