Introduction to Postman REST client
Tags: tutorial, beginners
Published: 2017-11-13 08:29:21

---
title: Introduction to Postman REST client
published: true
description: The Postman is a feature rich REST client. Thousands of developers used it to browse, test and even documenting APIs. This post aims to provide basic information you need to start using Postman
tags: tutorial,beginners
canonical_url: http://harshitrathod.com/2017/11/11/introduction-postman-rest-client/
---

This post was originally published on my blog [here](http://harshitrathod.com/2017/11/11/introduction-postman-rest-client/)

##Summary

The Postman is a feature rich REST client. Thousands of developers used it to browse, test and even documenting APIs. This post aims to provide basicÂ information you need to start using Postman

##Introduction

Started in 2012 with the idea of REST client Postman has improved itself to support all the feature you need for API development and testing. According to officials in 2014, it hasÂ 3+ million active users. You can make HTTP requests like GET, Â POST, Â PUT, Â DELETE from it. You can also perform automation test on your API using it. With monitoring feature, you can execute set of requests to check for its performance and response



It's available as a Chrome extension and native app build on The Electron. I recommended using the native app because Chrome extension will be deprecated soon. Â You can download it from here. In this post, we will use service callÂ Postman EchoÂ to mock our API



##Send your first request

Calling API from Postman is like a cakewalk. For simplicity, we will do a GET request to the server


![Screenshot of postman app while sending Request](http://harshitrathod.com/wp-content/uploads/2017/11/blog1.png)
1. URL of API
2. Request Type [GET, POST, PUT, DELETE]
3. Send button To call the API
4. Response Of API
5. More information
6. History of past API calls

###Send Post data withÂ Request:


![Post Request with Postman](http://harshitrathod.com/wp-content/uploads/2017/11/blogrequest.png)

While doing a POST request to the API you need to pass some data as a body. As given in the screenshot above, you can pass data while calling your API


![Post Request Response](http://harshitrathod.com/wp-content/uploads/2017/11/blogresonse.png)

##Collections

Postman provides good way to Organize your related request. It's called Collections.Â It's like folder structure so you can browse API. Also You can use collections with Test script but this will be explained later. You can create and browse Collection as displayed below

Â 

![Click New Button to Add Collection](http://harshitrathod.com/wp-content/uploads/2017/11/createCollection1.png)

![Provide Collection name and detail and then save Collection](http://harshitrathod.com/wp-content/uploads/2017/11/createcollection2.png)

![Click On save button to add a request to the Collection](http://harshitrathod.com/wp-content/uploads/2017/11/createcollection3.png)

![Add detail and select collection](http://harshitrathod.com/wp-content/uploads/2017/11/createcollection4.png)

![Form collection tab you can access your Collections](http://harshitrathod.com/wp-content/uploads/2017/11/createcollection5.png)
Â 

##Example

When you have different frontend and backend team, REST API design is the most important part. Â Frontend team doesn't want to refactor their code because of misunderstanding about API design. Postman solves this problem with the concept called "Example". You can save request/response parameter of your API as an Example. After saving your Example, You can share it with the team. You can also create a mock server with Postman mock server. frontend team can use it as an alternativeÂ to actual API


![Click on Add Example](http://harshitrathod.com/wp-content/uploads/2017/11/e1.png)

![Add request and response detail](http://harshitrathod.com/wp-content/uploads/2017/11/e2.png)

![Access Example](http://harshitrathod.com/wp-content/uploads/2017/11/e3.png)


##Conclusion

PostmanÂ is a day to day tool for any developer. Â Any backend developer can quickly check his API without any frontend application. Also, the developerÂ can write test script which will help them to do impact analysis of their change on API. Frontend developer can use this as an alternativeÂ to actual API which will make them independent of backend team