swaggman is an API specification converter that creates a Postman 2.0 Collection spec from a Swagger (OAI) 2.0 spec.

• Supports Postman scripts by accepting an optional base Postman 2.0 spec that contains information not readily stored in Swagger Spec to support functions such as OAuth Password Grant.
• Supports override URL hostname parameter to support a Postman environment variable for the URL hostname, e.g. https://{{MY_HOSTNAME}}/restapi
• Supports additional headers, e.g. authorization headers using enviroment variables, e.g. Authorization: Bearer {{myAccessToken}}

These are all used in the included example discussed below.

Additional discussion is available on Medium.

• Postman 4.10.7 does not natively support JSON requests so request bodies need to be entered using the raw body editor. A future task is to add Swagger request examples as default Postman request bodies.
• Postman 2.0 spec supports polymorphism and doesn't have a canonical schema. For example, the request.url property can be populated by a URL string or a URL object. Swaggman uses the URL object since it is more flexible. The function simple.NewCanonicalCollectionFromBytes(bytes) can be used to read either a simple or object based spec into a canonical object spec.
• This has only been used on the RingCentral Swagger spec to date but will be used for more in the future. Please feel free to use and contribute. Examples are located in the examples folder.

import( "github.com/grokify/swaggman" ) // Instantiate a converter with default configuration conv := swaggman.NewConverter(swaggman.Configuration{}) // Convert a Swagger spec err := conv.Convert("path/to/swagger.json", "path/to/pman.out.json")

import( "github.com/grokify/swaggman" "github.com/grokify/swaggman/postman2" ) // Instantiate a converter with overrides (using Postman environment variables) cfg := swaggman.Configuration{ PostmanURLHostname: "{{RC_SERVER_HOSTNAME}}", PostmanHeaders: []postman2.Header{postman2.Header{ Key: "Authorization", Value: "Bearer {{my_access_token}}"}}} conv = swaggman.NewConverter(cfg) // Convert a Swagger spec with a default Postman spec err := conv.MergeConvert("path/to/swagger.json", "path/to/pman.base.json", "path/to/pman.out.json")

An example conversion is included, examples/ringcentral/convert.go which creates a Postman 2.0 spec for the RingCentral REST API using a base Postman 2.0 spec and the RingCentral basic Swagger 2.0 spec.

A video of importing the resulting Postman collection is available on YouTube.

Example files include:

• RingCentral Swagger 2.0 spec
• RingCentral Postman 2.0 base
• RingCentral Postman 2.0 spec - Import this into Postman

The RingCentral spec uses the following environment variables. The following is the Postman bulk edit format:

RC_SERVER_HOSTNAME:platform.devtest.ringcentral.com RC_APP_KEY:myAppKey RC_APP_SECRET:myAppSecret RC_USERNAME:myMainCompanyPhoneNumber RC_EXTENSION:myExtension RC_PASSWORD:myPassword 

For multiple apps or users, simply create a different Postman environment for each.

To set your environment variables, use the Settings Gear icon and then click "Manage Environments"

• Medium: Using Postman, Swagger and the RingCentral API
• YouTube: Getting Started with RingCentral APIs using Postman