spectral:oas warn on by default

operation-parameters

Operation parameters are unique and non-repeating.

Applies to
parameters
Selects
#OperationObject.parameters
Function
oasOpParams
Specs
OpenAPI 2.0OpenAPI 3.0OpenAPI 3.1OpenAPI 3.2
Message
{{error}}

Use it

This rule ships with OpenLint in spectral:oas. Extending the ruleset turns it on:

extends: spectral:oas
rules:
  operation-parameters: warn   # or off, or another severity

Definition

As defined in @openlint/openlint-rulesets. Functions show by name.

operation-parameters:
  description: Operation parameters are unique and non-repeating.
  message: '{{error}}'
  recommended: true
  given: '#OperationObject.parameters'
  then:
    function: oasOpParams

About this rule

Operation parameters are unique and non-repeating.

  1. Operations must have unique name + in parameters.
  2. Operation cannot have both in: body and in: formData parameters. (OpenAPI v2.0)
  3. Operation must have only one in: body parameter. (OpenAPI v2.0)

Sources