cloudy-sky-software/pulschema

Handle request parameters defined at the path-level that are common to all operations

Closed this issue · 0 comments

It looks like API docs that are generated via readme.io use this form of defining parameters.

/services/{serviceId}/something:
    parameters:
      - $ref: '#/components/parameters/serviceIdParam'
    get:
      ...
    post:
      ...
    delete:
      ...

It's a legal way of defining request parameters that are applicable to all request methods under that path. Ref: https://swagger.io/specification/#path-item-object