README
postman2openapi
Convert Postman collections to OpenAPI definitions.
CLI
Installation
Archives of precompiled binaries for postman2openapi are available for Windows, macOS and Linux.
Linux binaries are static executables. Windows binaries are available either as built with MinGW (GNU) or with Microsoft Visual C++ (MSVC). When possible, prefer MSVC over GNU, but you'll need to have the Microsoft VC++ 2015 redistributable installed.
For Rust developers, installation is also available via Cargo. Installing Rust and Cargo
To install the latest published version on crates.io, use:
cargo install postman2openapi --features binary
To install from the latest on GitHub, use:
cargo install --git https://github.com/kevinswiber/postman2openapi --features binary
Usage
USAGE:
postman2openapi [OPTIONS] [input-file]
ARGS:
<input-file> The Postman collection to convert; data may also come from stdin
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-o, --output <format> The output format [default: yaml] [possible values: yaml, json]
Examples
postman2openapi collection.json > openapi.yaml
cat collection.json | postman2openapi -o json
Node.js library
Installation
npm install postman2openapi
Usage
const collection = require('./collection'); // any Postman collection JSON file
const { transpile } = require('postman2openapi');
const postman = JSON.stringify(collection);
const openapi = transpile(postman, 'yaml');
console.log(openapi);
JavaScript API
transpile(collection: string, format: string): string
- collection - a stringified version of a Postman JSON object.
- format - the return format, either
json
oryaml
. - returns - an OpenAPI definition in the format specified.
License
Apache License 2.0 (Apache-2.0)
Copyright © 2020 Kevin Swiber kswiber@gmail.com