Skip to content
Postman API Testing Tips

How To Use Postman For Api Testing Step By Step

API Testing Blog

A Comprehensive Guide to API Testing with Postman: Step by Step

Postman is a powerful tool for API testing, offering a user-friendly interface and a rich set of features to streamline your workflow. This guide will walk you through the essential steps, providing practical examples and code snippets to get you started.

Installing Postman

  1. Download Postman: Visit the official Postman website (https://www.postman.com/) and download the app for your operating system.
  2. Install Postman: Run the installer and follow the on-screen instructions to complete the installation process.
  3. Launch Postman: Once installed, open the Postman application.

Creating Your First API Request

  1. Open the Postman Interface: The main Postman window displays a workspace for you to manage your requests, collections, and environments.
  2. Build a Request: In the top left corner, click the New button and select Request.
  3. Select HTTP Method: Choose the appropriate HTTP method for your request (e.g., GET, POST, PUT, DELETE) from the dropdown menu.
  4. Enter Request URL: Type the complete URL of the API endpoint you want to interact with.
  5. Add Headers: For specific API requirements, click on the Headers tab and add key-value pairs for request headers.
  6. Send the Request: Click the Send button to execute your request.
  7. View Response: The response from the API will be displayed in the right pane, including status codes, headers, and body content.

Example: Let’s test a simple GET request to fetch a list of users from a sample API endpoint.

URL: https://reqres.in/api/users
HTTP Method: GET

Send the request and observe the response in the right pane. You should see a list of user objects with their details.

Organizing Requests with Collections

Collections in Postman allow you to group related requests, making API testing more organized and efficient.

  1. Create a New Collection: Click the New button and select Collection.
  2. Name Your Collection: Provide a descriptive name for your collection.
  3. Add Requests: Click the + button within the collection and choose Request.
  4. Define Your Request: Configure your request details as described in the previous section.
  5. Save to Collection: After making changes, click the Save button in the request editor.

Example: Let’s create a collection named “User Management” and add the following requests:

  • Get Users (GET): Retrieves a list of users.
  • Create User (POST): Adds a new user to the database.
  • Get User by ID (GET): Fetches details of a specific user.
  • Update User (PUT): Modifies an existing user’s information.
  • Delete User (DELETE): Removes a user from the system.

Using Environments for Dynamic API Configuration

Environments in Postman provide a mechanism to manage different API configurations such as URLs, API keys, and other variables.

  1. Create a New Environment: Click the Manage Environments button (looks like a gear icon) in the top right corner and select Add.
  2. Define Variables: Add key-value pairs for each variable needed for your API requests.
  3. Select Environment: Choose the relevant environment for your request from the dropdown menu in the request editor.
  4. Use Environment Variables: Refer to environment variables in your request URL, headers, or body using curly braces (e.g., {{variable_name}}).

Example: Let’s create two environments: “Development” and “Production.”

  • Development:
    • base_url: https://api.example.com/dev
    • api_key: your_development_key
  • Production:
    • base_url: https://api.example.com/prod
    • api_key: your_production_key

Now, in your collection requests, you can use {{base_url}} and {{api_key}} to dynamically access the correct environment settings.

Adding Assertions for Validation

Assertions help ensure the expected behavior of your API endpoints by validating responses.

  1. Open the Test Tab: Navigate to the Tests tab within the request editor.
  2. Write Assertions: Use the Postman test scripting language (pm.test()) to validate response elements such as status codes, response headers, and body content.
  3. Run and Review Tests: Send the request and observe the test results. Pass/fail indicators will be displayed in the Test Results section.

Example: Let’s add an assertion to verify the status code of a GET request:

pm.test("Status code is 200", () => {
  pm.response.to.have.status(200);
});

This assertion checks if the response status code is 200 (OK). You can add more complex tests to validate specific data fields in the response body.

Working with Pre-request Scripts (Optional)

Pre-request scripts allow you to execute code before sending the actual request. This can be useful for setting up request parameters, generating dynamic data, or performing other tasks.

  1. Open the Pre-request Script Tab: Navigate to the Pre-request Script tab within the request editor.
  2. Write JavaScript Code: Implement your desired logic using JavaScript.
  3. Set Request Values: Modify request elements like headers, body parameters, or URL path variables using Postman’s JavaScript API.

Example: Let’s use a pre-request script to generate a random user ID:

// Generate a random user ID
var randomUserId = Math.floor(Math.random() * 1000);


// Set the user ID in the request URL
pm.request.url.path.push(randomUserId);

This script will generate a random number between 0 and 999 and append it to the request URL.

API Testing Blog