Skip to content
Postman API Testing Tips

How To Use Params In Postman

API Testing Blog

Understanding Parameters and Postman

Parameters are essential components of APIs that allow you to customize requests and provide dynamic data. Postman is a powerful tool for testing APIs, offering flexible ways to manage and utilize parameters. This guide explores various techniques for effectively using parameters within Postman.

1. Defining Request Parameters

Parameters can be passed in your API requests in two primary ways:

a) Query Parameters: Appended to the URL after a question mark (?). They are key-value pairs separated by ampersands (&).

b) Body Parameters: Included in the request body, usually sent as JSON or XML. They are used for sending complex data structures.

Example:

Request URL: https://api.example.com/users?name=John&age=30 Query parameters: name=John, age=30

Request Body:

{
  "name": "Jane",
  "email": "jane.doe@example.com"
}

Body Parameters: name, email

2. Sending Parameters in Postman

a) Query Parameters:

  1. Directly in the URL:

    • In the Postman request URL bar, simply add the parameters after the question mark, separated by ampersands.

    Example: https://api.example.com/users?name=John&age=30

  2. Using the “Params” Tab:

    • Navigate to the “Params” tab in the Postman request builder.
    • Enter the key-value pairs for each parameter.

b) Body Parameters:

  1. JSON Body:

    • Select “raw” as the body type and choose “JSON” as the format.
    • Paste or enter the JSON data with your parameters.

    Example:

    {
      "name": "Jane",
      "email": "jane.doe@example.com"
      }

  2. Form Data:

    • Select “form-data” as the body type.
    • Add each parameter as a key-value pair.

Example:

  • Key: name
  • Value: Jane

3. Using Variables for Dynamic Parameters

For increased flexibility, Postman allows you to define variables and reuse them in your requests.

a) Environment Variables:

  • Define variables in the “Environments” section of Postman.
  • Use the syntax {{variableName}} in your requests to access them.
  • This allows you to switch between different environments easily.

Example:

  • Environment: dev
  • Variable: baseUrl
  • Value: https://api.dev.example.com

Request URL: {{baseUrl}}/users

b) Collection Variables:

  • Variables can be defined at the collection level for wider scope.
  • Use the syntax {{#variableName}} to access them in requests.

4. Testing Parameters with Pre-request Scripts

Postman’s pre-request scripts enable you to manipulate and use parameters programmatically.

a) Generating Dynamic Parameters:

  • Use JavaScript code in the pre-request script to calculate, transform, or fetch parameter values.

Example:

let timestamp = Date.now();
pm.environment.set("timestamp", timestamp);

b) Conditional Logic:

  • Combine pre-request scripts with conditional statements (if, else) to control parameter values based on specific requirements.

Example:

if (pm.environment.get("environment") === "prod") {
  pm.environment.set("apiEndpoint", "https://api.prod.example.com");
} else {
  pm.environment.set("apiEndpoint", "https://api.dev.example.com");
}

5. Validating Parameter Responses

Postman’s testing features allow you to ensure your API correctly handles parameters:

a) Assertions:

  • Use assertions within your tests to verify parameter values in the response.

Example:

pm.test("Name should be John", function () {
  pm.response.to.have.body('John')
});

b) Data Extraction:

  • Utilize Postman’s data extraction features to retrieve specific parameter values from the response and use them in subsequent requests.

Example:

let userId = pm.response.json().id;
pm.environment.set("userId", userId);

API Testing Blog