operation-parameters-unique

Verifies parameters are unique for any given operation.

API design principles

Identical twins are the topic of social research. And some interesting studies have been published over the years that used identical twins in their studies. Identical parameters, on the other hand, are a design mistake. Solve it before you ship it.

Configuration

An example configuration:

rules:
  operation-parameters-unique: error

Examples

Given this configuration:

rules:
  operation-parameters-unique: error

Example of an incorrect operation:

paths:
  /cars:
    get:
      parameters:
        - name: filter
          in: query
        - name: filter
          in: query

Example of a correct operation:

paths:
  /cars:
    get:
      parameters:
        - name: filter
          in: query
        - name: another-filter
          in: query

Related rules

• path-parameters-defined

Resources

• Rule source
• Operation object docs
• Parameter object docs