Last updated

no-server-variables-empty-enum

Disallow server variables without enum list defined.

OASCompatibility
2.0❌
3.0✅
3.1✅
root
ServersList
Server
ServerVariables

API design principles

If you use server variables, there are generally two kinds:

  • tenant-driven
  • environment-driven

In the case of environment-driven variables, you may want to predefine all of the possible values.

Configuration

OptionTypeDescription
severitystringPossible values: off, warn, error. Default error (in recommended configuration).

An example configuration:

rules:
  no-server-variables-empty-enum: error

Examples

Given this configuration:

rules:
  no-server-variables-empty-enum: error

Example of incorrect server variables:

servers:
  - url: 'https://{env}.example.com/api/v1'
    variables:
      env:
        default: api
        description: Environment

Example of correct server:

servers:
  - url: 'https://{env}.example.com/api/v1'
    variables:
      env:
        default: api
        description: Environment
        enum:
          - api
          - sandbox
          - qa
          - test
          - dev

Resources