- Validate Swagger/OpenAPI files in JSON or YAML format
- Supports multi-file API definitions via
- Bundle multiple Swagger/OpenAPI files into one combined file
Install using npm:
npm install -g swagger-cli
swagger-cli <command> [options] <file> Commands: validate Validates an API definition in Swagger 2.0 or OpenAPI 3.0 format bundle Bundles a multi-file API definition into a single file Options: -h, --help Show help for any command -v, --version Output the CLI version number -d, --debug [filter] Show debug output, optionally filtered (e.g. "*", "swagger:*", etc.)
Validate an API
swagger-cli validate command will validate your Swagger/OpenAPI definition against the Swagger 2.0 schema or OpenAPI 3.0 Schema. It also performs additional validations against the specification, which will catch some things that aren't covered by the schema, such as duplicate parameters, invalid MIME types, etc.
The command will exit with a non-zero code if the API is invalid.
swagger-cli validate [options] <file> Options: --no-schema Do NOT validate against the Swagger/OpenAPI JSON schema --no-spec Do NOT validate against the Swagger/OpenAPI specification
Combine Multiple Files
The Swagger and OpenAPI specs allows you to split your API definition across multiple files using
$ref pointers to reference each file. You can use the
swagger-cli bundle command to combine all of those referenced files into a single file, which is useful for distribution or interoperation with other tools.
By default, the
swagger-cli bundle command tries to keep the output file size as small as possible, by only embedding each referenced file once. If the same file is referenced multiple times, then any subsequent references are simply modified to point to the single inlined copy of the file. If you want to produce a bundled file without any
$ref pointers, then add the
--dereference option. This will result in a larger file size, since multiple references to the same file will result in that file being embedded multiple times.
If you don't specify the
--output-file option, then the bundled API will be written to stdout, which means you can pipe it to other commands.
The result of this method by default is written as JSON. It can be changed to YAML with the
--type option, by passing the
swagger-cli bundle [options] <file> Options: -o, --outfile <file> The output file -r, --dereference Fully dereference all $ref pointers -f, --format <spaces> Formats the output using the given number of spaces (the default is 2 spaces) -t, --type <filetype> Defines the output file type. The valid values are: json, yaml (the default is JSON) -w, --wrap <column> Set the line length for YAML strings (the default is no wrapping)
To build/test the project locally on your computer:
Clone this repo
git clone https://github.com/APIDevTools/swagger-cli.git
Run the tests
Swagger CLI is 100% free and open-source, under the MIT license. Use it however you want.