swagger: 2.0
info:
  version: "1.0.0"
  title: query-parameters
parameters:
  fields:
    name: fields
    in: query
    description: >-
      Comma separated list of fields that should be returned. Fields of
      sub-objects are specified in dot-Notation

      Example: fields=id,name,brand.key,brand.name,units.id,units.size,price.formatted
    required: false
    type: string

  sort:
    description: >-
      Comma separated list of sort-fields that should be evaluated for sorting the result.
      Sort-fields of sub-objects are specified with dots as separator. Sort-fields of objects within
      lists are specified in the same way. The sorting direction is indicated with a `+` prefix for
      ascending and a `-` prefix for descending.

      Example: sort=+id,-name,+units.size
    name: sort
    in: query
    required: false
    type: array
    items:
      type: string

  limit:
    description: >-
      Page-size limit for request.

      Example: limit=10
    name: limit
    in: query
    required: false
    type: integer
    minimum: 1
    maximum: 100
    default: 10

  offset:
    description: >-
      Offset page for request.

      Example: offset=0
    name: offset
    in: query
    required: false
    type: integer
    minimum: 0
    maximum: 999
    default: 0
