OpenAPI Best Practices

OpenAPI Best Practices

This ruleset contains 12 best practices based on recommendations from the OpenAPI 3.0 Specification. This ruleset is backward compatible with OpenAPI 2.0.

Links:
- OpenAPI Specification v3.0.3
- OpenAPI Specification v2.0
- GitHub OAI/OpenAPI-Specification

Rules in this Ruleset

Violations

• operation-default-response
• operation-operationId

Warnings

• operation-singular-tag
• tag-description
• info-contact
• info-description
• info-license
• license-url
• openapi-tags
• operation-description
• operation-tags
• operation-tag-defined