How to define query parameter limits?

[mohsen1]

How can I have a query parameter that has more than just type? Here is my query parameter:

- name: limit
  in: query
  description: number of pets to return
  type: integer

But I want to limit query param to be no less than 10 and no more than 1000. How can I do that?

[webron]

That's where the minimum and maximum come in. So you'd have:

- name: limit
  in: query
  description: number of pets to return
  type: integer
  minimum: 10
  maximum: 1000

For a full list of validation constraints, check out https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#parameterObject - specifically the fields for parameters that are not body.

[mohsen1]

Is it safe to say parameter object is an extension of json schema?

[webron]

No, just like the Schema Object is not an extension of json schema. It uses a subset of json schema, with additional limitations to the subset and additional fields as well. Looking at it as an extension of json schema may lead to people trying to use it in ways that are not supported.

[webron]

Closing this for now. Please reopen if still an issue.