info-contact

Requires the Contact info object defined in your API.

API design principles

When it comes to APIs, we generally want more consumers. If they need help to purchase, integrate, or troubleshoot, your contact info should be front and center.

Configuration

An example configuration:

rules:
  info-contact: warn

Examples

Given this configuration:

rules:
  info-contact: error

Example of incorrect contact:

info:
  version: 1.0.0
  title: Incorrect example missing contact
  termsOfService: 'https://example.com/terms/'
  license:
    name: Apache 2.0
    url: 'http://www.apache.org/licenses/LICENSE-2.0.html'

Example of correct contact:

info:
  contact:
    name: Redocly API Support
    url: https://www.redocly.com/support
    email: support@redocly.com

Related rules

• info-license
• info-license-url
• spec
• configurable rules

Resources

• Rule source
• Contact object docs