postman
TLDR
Launch Postman
$ postman
Run collection from CLI$ newman run [collection.json]
Run with environment$ newman run [collection.json] -e [environment.json]
Export results$ newman run [collection.json] --reporters cli,json --reporter-json-export [results.json]
SYNOPSIS
postman [options]
newman run collection [options]
DESCRIPTION
Postman is an API development platform with a GUI for designing, testing, and documenting APIs. Newman is its command-line companion for running collections in CI/CD.
EXAMPLES
$ # Launch GUI
postman
# Run collection with Newman
newman run my-api-tests.json
# With environment
newman run collection.json -e staging.json
# Data-driven testing
newman run collection.json -d testdata.csv -n 10
# Multiple reporters
newman run collection.json --reporters cli,htmlextra
postman
# Run collection with Newman
newman run my-api-tests.json
# With environment
newman run collection.json -e staging.json
# Data-driven testing
newman run collection.json -d testdata.csv -n 10
# Multiple reporters
newman run collection.json --reporters cli,htmlextra
PARAMETERS (newman)
-e, --environment file
Environment file.-g, --globals file
Global variables.-d, --iteration-data file
Data file for iterations.-n count
Iteration count.--reporters list
Output reporters.--timeout ms
Request timeout.
COLLECTION FORMAT
Postman collections (JSON) contain:
- Requests with URLs, methods, headers
- Tests (JavaScript assertions)
- Variables and environments
CAVEATS
Postman GUI requires account for cloud features. Newman runs locally without account. Free tier has limitations.
HISTORY
Postman was founded by Abhinav Asthana in 2014, evolving from a Chrome extension to a full API platform.
