Postman Learning Center
Postman is the collaboration platform for API development. The Postman Learning Center has the resources you need to ramp up quickly and extend your skills with Postman. Postman enables you to write API test cases in any format of your choice (JSON/XML/many more) and run them to verify and validate your API. Moreover, Postman provides collections which can improve a developer's workflow. There are also powerful tools for API-first development, including writing API schemas and generating server code. Postman is available for several platforms including Windows, macOS, and Linux. For more information visit the Postman website.
Contribution guidelines
We would love for you to contribute to the Learning Center! To contribute to this project, please read:
NOTE: We have added a new Markdown linter with GitHub Actions. When making a pull request, it will run against this linter. Your changed files are required to pass linting before they will be merged. More information on this can be found in the contribution guidelines.
To say thank you for your contribution, we’d love to send you exclusive Contributor swag. Fill out the Contributor Submission form and we’ll send you a token of our gratitude.
Build the Learning Center locally
$ git clone https://github.com/postmanlabs/postman-docs.git
$ cd postman-docs
$ npm install
$ npm install -g gatsby-cli
$ npm run dev
NOTE: this site was built with node v14.15.0. We recommend installing and using nvm and setting your node version to v14.15.0.
Build using Docker
You can build the Learning Center and run it in a Docker container by creating a dockerfile
.
-
Start by cloning the the repository
git clone https://github.com/postmanlabs/postman-docs.git
-
Create a file and name it
dockerfile
with the following contents:FROM node:14 EXPOSE 8000 # copy the postman-docs project directory COPY postman-docs /var/postman-docs WORKDIR "/var/postman-docs" RUN npm install -g gatsby-cli RUN npm install --force CMD ["yarn", "dev", "-H", "0.0.0.0" ]
The
dockerfile
should be in the same directory as thepostman-docs
directory# example directory structure |--[current folder] |--postman-docs |--dockerfile
-
Build the Docker image with this command:
$ docker build --tag postman-docs:1.0 .
-
Start a container using the image
$ docker run -p 8000:8000 -d postman-docs:1.0
Docker Compose
You can also build with the docker-compose
command using the dockerfile above and this docker-compose.yaml
version: '3'
services:
node:
build:
context: ./
ports:
- "8000:8000"
The docker-compose.yaml should be in the same directory as the postman-docs directory and dockerfile.
# example directory structure
|--[current folder]
|--postman-docs
|--dockerfile
|--docker-compose.yaml
Start run the container with this command
$ docker-compose up
Project Structure
The built site will only host the most up-to-date docs. All legacy documentation is stored in GitHub and excluded from build.
To update the docs
-
Posts are maintained under the
/src/pages/docs
folder. -
The folder structure of /docs is the URL structure for posts. For example,
/docs/postman/variables-and-environments/variables.md
is mapped to the URLhttps://learning.postman.com/docs/postman/variables-and-environments/variables/
. -
Links in the docs should be relative. Example:
[Newman](/docs/postman/collection-runs/command-line-integration-with-newman/)
Resources
- Download Postman
- Postman Release Notes
- Postman Integrations
- The Postman API
- Postman community on Discourse