swagger-api / swagger.io-docs

The content of swagger.io
https://swagger.io/docs/
1.56k stars 400 forks source link

Serialization and RFC 6570 example is incorrect #234

Closed cvgaviao closed 5 years ago

cvgaviao commented 5 years ago

In the Parameter Serialization doc page, item Serialization and RFC 6570, it is being explained the the serialization of path parameter (id), but in the example provided a query parameter is specified for id.

For example, consider the path /users{id} with a query parameter metadata, defined like so:

    paths:
      # /users;id=3;id=4?metadata=true
      /users{id}:
        get:
          parameters:
            - in: *query*
              name: id
              required: true
              schema:
                type: array
                items:
                  type: integer
                minItems: 1
              style: matrix
              explode: true
            - in: query
              name: metadata
              schema:
                type: boolean
              # Using the default serialization for query parameters:
              # style=form, explode=false, allowReserved=false
          responses:
            '200':
              description: A list of users
hkosova commented 5 years ago

Fixed. Thanks @cvgaviao!