Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/postmanlabs/postman-collection

Javascript module that allows a developer to work with Postman Collections
https://github.com/postmanlabs/postman-collection

postman-apps postman-collection sdk

Last synced: 3 months ago
JSON representation

Javascript module that allows a developer to work with Postman Collections

Lists

README 

        
# Postman Collection SDK [![Build Status](https://github.com/postmanlabs/postman-collection/actions/workflows/ci.yml/badge.svg?branch=develop)](https://github.com/postmanlabs/postman-collection/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/postmanlabs/postman-collection/branch/develop/graph/badge.svg)](https://codecov.io/gh/postmanlabs/postman-collection)



Postman Collection SDK is a NodeJS module that allows a developer to work with Postman Collections. Using this module a

developer can create collections, manipulate them and then export them in a format that the Postman Apps and Postman CLI

Runtimes (such as [Newman](https://github.com/postmanlabs/newman)) can consume.



A collection lets you group individual requests together. These requests can be further organized into folders to

accurately mirror your API. Requests can also store sample responses when saved in a collection. You can add metadata

like name and description too so that all the information that a developer needs to use your API is available easily.



To know more about Postman Collections, visit the

[collection documentation section on Postman Website](https://www.getpostman.com/collection).



> The new [Collection Format v2](http://blog.getpostman.com/2015/06/05/travelogue-of-postman-collection-format-v2/)

> builds a stronger foundation for improving your productivity while working with APIs. We want your feedback and iron

> out issues before this goes into the Postman Apps.



## Installing the SDK



Postman Collection SDK can be installed using NPM or directly from the git repository within your NodeJS projects. If

installing from NPM, the following command installs the SDK and saves in your `package.json`



```terminal

> npm install postman-collection --save

```



## Getting Started



In this example snippet we will get started by loading a collection from a file and output the same in console.



```javascript

var fs = require('fs'), // needed to read JSON file from disk

	Collection = require('postman-collection').Collection,

	myCollection;



// Load a collection to memory from a JSON file on disk (say, sample-collection.json)

myCollection = new Collection(JSON.parse(fs.readFileSync('sample-collection.json').toString()));



// log items at root level of the collection

console.log(myCollection.toJSON());

```



After loading the collection from file, one can do a lot more using the functions that are available in the SDK. To know

more about these functions, head over to

[Collection SDK Docs](http://www.postmanlabs.com/postman-collection).



## Postman Collection Schema



The collection schema outlines the JSON definition of data structure accepted by the constructor of each properties of

this SDK. In other words, this SDK provides JavaScript level object manipulation for the JSON structure defined by

Postman Collection Format in [http://schema.postman.com/](http://schema.postman.com/).



| Schema Version | Compatible SDK Versions |

|----------------|-------------------------|

| 1.0            | none                    |

| 2.0            | <3.0                    |

| 2.1            | >= 3.0                  |



Conceptually, a JSON input to the constructor of an SDK property should provide similar output when that property

instance's `.toJSON()` is called.