Skip to content
Postman API Testing Tips

How To Test Web Services Using Postman

API Testing Blog

Getting Started with Postman for Web Service Testing

Postman is a powerful tool for testing web services. It provides a user-friendly interface for making API requests, inspecting responses, and automating tests. This guide will walk you through the basics of using Postman for web service testing.

1. Setting Up Your Environment

First, you’ll need to install Postman. Download the desktop app from their website or use the Chrome extension.

1.1 Create a New Request

Once Postman is installed, open the app and click the “New” button to create a new request.

1.2 Select HTTP Method

Choose the appropriate HTTP method for your request. Common methods include:

  • GET: Retrieve data from a server.
  • POST: Submit data to a server.
  • PUT: Update data on a server.
  • DELETE: Delete data from a server.

1.3 Enter the Endpoint URL

In the URL field, enter the endpoint URL of the web service you want to test. For example: https://api.example.com/users

1.4 Add Headers (Optional)

If the web service requires authentication or other headers, add them by clicking the “Headers” tab and entering the key-value pairs.

1.5 Add Body (Optional)

For POST, PUT, or PATCH requests, you’ll need to add the data you want to send to the server in the “Body” tab. Select the appropriate format (e.g., JSON, XML) and enter the data.

1.6 Send the Request

Click the “Send” button to execute your request.

2. Inspecting and Analyzing Responses

Postman automatically displays the response from your request in the “Response” tab. This includes:

  • Status Code: Indicates the success or failure of the request (e.g., 200 - OK, 404 - Not Found).
  • Headers: Contains information about the response, such as content type and encoding.
  • Body: The actual data returned by the server.

3. Writing Assertions with Test Scripts

Postman allows you to write JavaScript code to automatically verify the correctness of responses. This is known as “test scripting.”

3.1 Accessing Response Data

Within your test script, you can access the response data using the pm object. For instance:

// Check if the status code is 200
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});


// Verify the response body contains a specific value
pm.test("Response body contains 'success'", function () {
    pm.expect(pm.response.text()).to.include("success");
});


// Check the response headers
pm.test("Content-Type header is 'application/json'", function () {
    pm.response.to.have.header("Content-Type", "application/json");
});

3.2 Creating Test Suites

To organize your tests, create test suites by clicking the “Tests” tab and writing custom functions.

3.3 Running Tests Automatically

Postman supports various ways to execute tests automatically:

  • Collections: Group related requests and tests into collections for organized execution.
  • Environments: Manage different configurations for your tests, such as API endpoints and authentication credentials.
  • Runners: Run tests and generate reports for easy analysis.

4. Practical Example: Testing a User API

Scenario: You’re testing a user API endpoint that retrieves a list of users.

4.1 Create a GET Request:

  • Endpoint URL: https://api.example.com/users

4.2 Send Request and Inspect Response:

  • Ensure the status code is 200 (OK).
  • Verify the response body is in JSON format and contains an array of user objects.

4.3 Write Test Script:

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


pm.test("Response body is JSON", function () {
    pm.expect(pm.response.json()).to.be.an('array');
});


pm.test("Response contains at least one user", function () {
    pm.expect(pm.response.json()).to.have.length.above(0);
});

4.4 Run Test Suite:

  • Create a test suite called “User API Tests”.
  • Run the tests and view the results in the “Test Results” tab.

5. Working with Environments and Collections

5.1 Creating Environments:

  • Define variables like API base URL, authentication tokens, etc.
  • Use environments to manage different test configurations.

5.2 Utilizing Collections:

  • Group related requests and tests into collections.
  • Leverage features like data-driven testing and pre-request scripts.

6. Conclusion

Postman is an invaluable tool for API testing due to its ease of use, wide range of features, and powerful scripting capabilities. By utilizing its features effectively, you can efficiently test web services and ensure their quality.

API Testing Blog