Empty parameters array in swagger 2.0 spec yields a validation error

[who]

If you have a HTTP GET path defined with an empty parameters array, the built-in validator will complain.

Here's a yaml block you can use for repro:

swagger: '2.0'
info:
  version: "0.0.0"
  title: "My bug repro API"
paths:
  /persons:
    get:
      # Describe this verb here. Note: you can use markdown
      description: |
        Gets `Person` objects.
        Optional query param of **size** determines
        size of returned array
      # This is an empty parameters array
      parameters: []
      responses:
        200:
          description: Successful response
          schema:
            title: ArrayOfPersons
            type: array
            items:
              title: Person
              type: object
              properties:
                name:
                  type: string
                single:
                  type: boolean

The validator message contains this:

Array is too short (0), minimum 1
code: "ARRAY_LENGTH_SHORT"
message: "Array is too short (0), minimum 1"
path: Array [4]
0: "paths"
1: "/persons"
2: "get"
3: "parameters"
description: "The parameters needed to send a valid API call."
level: 900

It appears this issue is similar to swagger-api/validator-badge#11

[who]

After further digging, this is a bug surfaced from the swagger 2.0 spec as it is defined by apigee-127/swagger-tools.

[mohsen1]

The schema has updated to fix this issue. It will get resolved when we update to the latest swagger-tools which has latest schema.

[mohsen1]

@whitlockjc I thought you updated the schema in swagger-tools already. Please open a ticket in swagger-tools for updating the schema in the next release and link it to this issue if it's not the case

[whitlockjc]

I did not, I've not put any time to swagger-tools due to other projects. I'll get it fixed tomorrow.

[who]

@mohsen1

It looks like swagger-tools has updated the schema.

[mohsen1]

@who it's not published yet. @whitlockjc

[mohsen1]

Fix for this is deployed now.

[who]

🤘 Thank you!

[ayushidalmia]

I still get the error.
https://gist.github.com/ayushidalmia/a903db41ece0071747601e8a64b35007

[webron]

That has nothing to do with the topic of this issue.