no-server-example.com

Prevents using example.com as the value of the servers.url fields in your API descriptions. The rule checks for all URL schemes (http, https...).

OAS Compatibility
2.0 ❌
3.0 ✅
3.1 ✅
root
ServersList

API design principles

Although commonly used in different kinds of documentation, example.com is not a real API server. Your consumers cannot use it to test your APIs. Be helpful - give them something they can use.

If you can't reveal a production server, consider a Redocly mock server instead.

Configuration

Option Type Description
severity string Possible values: off, warn, error. Default warn (in recommended configuration).

An example configuration:

Copy
Copied
rules:
  no-server-example.com: error

Examples

Given this configuration:

Copy
Copied
rules:
  no-server-example.com: error

Example of incorrect server:

Copy
Copied
servers:
  - url: https://example.com
    description: Example server

Example of correct server:

Copy
Copied
servers:
  - url: https://swift-squirrel.remockly.com
    description: Mock server

Related rules

Resources