Swagger/OpenAPI - use $ref to pass a reusable defined parameter

Question

Let\'s say I\'ve got a parameter like limit. This one gets used all over the place and it\'s a pain to have to change it everywhere if I need to update it:

Answer 1

For completeness, here's how it would look like in OpenAPI (a.k.a swagger v3):

openapi: "3.0.0"
servers:
    - url: /v1
      description: local server

paths:
   /path:
      get:
         parameters:
            - $ref: "#/components/parameters/limitParam"

components:
   parameters:
      limitParam:
         name: limit
         in: query
         description: Limits the number of returned results
         required: false
         schema:
            type: integer
            minimum: 10
            default: 10
            multipleOf: 10 # matches 10, 20, ...
            format: int32