This extension can be used to validate and lint OpenAPI 3.0.x documents, and convert between OpenAPI 2.0 and 3.0.0. It provides 11 Visual Studio Code commands:
OpenAPI Validate - which fully validates your OpenAPI document against the specification
OpenAPI Lint - which additionally applies a lightly-opinionated set of best-practices
OpenAPI Resolve and Validate - which pulls in external $refs before validating
OpenAPI Resolve and Lint - which pulls in external $refs before linting
OpenAPI Resolve (Bundle) - which resolves external $refs to a new window
OpenAPI 2.0 to 3.0.0 (YAML) - which converts the current OpenAPI 2.0 document to 3.0.0 in YAML
OpenAPI 2.0 to 3.0.0 (JSON) - which converts the current OpenAPI 2.0 document to 3.0.0 in JSON
OpenAPI 2.0 to 3.0.0 (YAML/Resolved) - like the above but resolving external $refs
OpenAPI 2.0 to 3.0.0 (JSON/Resolved) - like the above but resolving external $refs
OpenAPI to JSON - which simply translates the current document to JSON
OpenAPI to YAML - which simply translates the current document to YAML
The validator enforces semantic restrictions which cannot be expressed by the JSON Schema which drives the intellisense features, so it will pick up on many more errors.
The linter applies a lightly opinionated set of 'best practices' to your API document, making it complete and comprehensive, as opposed to merely minimally valid.
The default linter rules are documented here. The linter DSL rules format is also documented.
