swagger-linter

1.0.0 • Public • Published

API Definition Validator

  • npm package to validate Swagger definitions or OpenAPI definitions

You can validate API definition(s) using either validation level 1 or 2;

  • Validation level 1: validate API definition(s) as in WSO2 API Manager 4.0.0
  • Validation level 2: Fully validate API definition(s)

Usage

Clone this repo and run the following commnds

npm i

npm link

Validate provided Swagger or OpenAPI definition

swagger-linter -f [path to API definition JSON or YAML] -l [validation level 1 or 2]

or

Validate a directory of Swagger definitions and/or OpenAPI definitions

swagger-linter -d [path to directory with API definitions] -l [validation level 1 or 2]

Ignored validation rules for level 1

  • host (oas2-schema): "host" property must match pattern "^[^{}/ :\\]+(?::\d+)?$".
  • basePath (oas2-schema): "basePath" property must match pattern "^/".
  • extraInfo (oas2-schema): Property "extraInfo" is not expected to be here.

Package Sidebar

Install

npm i swagger-linter

Weekly Downloads

3

Version

1.0.0

License

ISC

Unpacked Size

13.9 MB

Total Files

9

Last publish

Collaborators

  • ashera